KsReferenceBusObject-Funktion (ks.h)

Verweist auf das Objekt des physischen Busgeräts.

Syntax

KSDDKAPI NTSTATUS KsReferenceBusObject(
  [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

Gibt STATUS_SUCCESS zurück, wenn der Verweis erfolgreich war, andernfalls ein Fehler wie STATUS_INSUFFICIENT_RESOURCES.

Bemerkungen

Diese Funktion wird von Filtern verwendet, die den Geräteheader verwenden, um den PnP-Objektstapel nachzuverfolgen. Dies wird normalerweise für ein erfolgreiches Öffnen des Filters aufgerufen, wenn der Bus für dieses Gerät einen solchen Verweis erfordert (z. B. Softwaregeräte), und wird durch einen Aufruf von KsDereferenceBusObject bei einem Schließen dieser Filterinstanz abgeglichen. Der Aufrufer muss zuvor auch als "KsSetDevicePnpAndBaseObject" bezeichnet werden, um das PnP-Gerätestapelobjekt festzulegen. Dies wäre in der PnP-AddDevice-Funktion geschehen. Wenn das Objekt zuvor nicht referenziert wurde, wird der Schnittstellenbereich zugewiesen, und die Funktion verwendet das PnP-Geräteobjekt, um die Busreferenzschnittstelle zu erhalten. Anschließend wird die ReferenceDeviceObject-Methode für diese Schnittstelle aufgerufen. Die Schnittstelle selbst wird freigegeben und freigegeben, wenn der Geräteheader freigegeben wird.

Anforderungen