KsDereferenceBusObject-Funktion (ks.h)

Dereferenziert das Objekt des physischen Geräts des Busses.

Syntax

KSDDKAPI VOID KsDereferenceBusObject(
  [in] KSDEVICE_HEADER Header
);

Parameter

[in] Header

Verweist auf einen Header, der zuvor von KsAllocateDeviceHeader zugeordnet wurde und auch das PnP-Gerätestapelobjekt enthält.

Rückgabewert

Keine.

Hinweise

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, wenn dies vom Bus für das angegebene Gerät erforderlich ist. Beispielsweise würde ein Softwaregerät einen solchen Aufruf erfordern. Dieser Aufruf entspricht einem vorherigen Aufruf von KsReferenceBusObject, wenn der Filter instance geöffnet wird. Der Aufrufer muss zuvor auch KsSetDevicePnpAndBaseObject aufgerufen haben, um das PnP-Gerätestapelobjekt festzulegen. Dies wäre in der PnP-AddDevice-Funktion erfolgt. 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