KsDereferenceBusObject-Funktion (ks.h)

Leitet das physische Geräteobjekt des Busses ab.

Syntax

KSDDKAPI VOID KsDereferenceBusObject(
  [in] KSDEVICE_HEADER Header
);

Parameter

[in] Header

Verweist auf eine Kopfzeile, die zuvor von KsAllocateDeviceHeader zugewiesen wurde, die auch das PnP-Gerätestapelobjekt enthält.

Rückgabewert

Nichts.

Bemerkungen

Dies wird von Filtern verwendet, die den Geräteheader verwenden, um den entsprechenden PnP-Objektstapel nachzuverfolgen. Dies wird normalerweise beim Schließen eines Filters aufgerufen, falls vom Bus für das angegebene Gerät erforderlich. Ein Softwaregerät würde z. B. einen solchen Anruf erfordern. Dieser Aufruf entspricht einem vorherigen Aufruf von KsReferenceBusObject beim Öffnen der Filterinstanz. Der Aufrufer muss zuvor auch KsSetDevicePnpAndBaseObject- aufgerufen haben, um das PnP-Gerätestapelobjekt festzulegen. Dies wäre in der PnP-AddDevice--Funktion geschehen. Die Funktion ruft die DereferenceDeviceObject Methode für die zuvor abgerufene Schnittstelle auf. Die Schnittstelle selbst wird freigegeben und freigegeben, wenn der Geräteheader freigegeben wird.

Anforderungen