KsReferenceBusObject-Funktion (ks.h)

Verweist auf das Objekt des physischen Busgeräts.

Syntax

KSDDKAPI NTSTATUS KsReferenceBusObject(
  [in] KSDEVICE_HEADER Header
);

Parameter

[in] Header

Zeigt auf einen Header, der zuvor von KsAllocateDeviceHeader zugewiesen wurde und 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.

Hinweise

Diese Funktion wird von Filtern verwendet, die den Geräteheader verwenden, um den PnP-Objektstapel nachzuverfolgen. Dies wird normalerweise bei einem erfolgreichen Öffnen des Filters aufgerufen, wenn der Bus für dieses Gerät einen solchen Verweis (z. B. Softwaregeräte) erfordert, und wird durch einen Aufruf von KsDereferenceBusObject beim Schließen dieses Filters instance abgeglichen. Der Aufrufer muss zuvor auch KsSetDevicePnpAndBaseObject genannt haben, um das PnP-Gerätestapelobjekt festzulegen. Dies wäre in der PnP AddDevice-Funktion geschehen. Wenn zuvor nicht auf das Objekt verwiesen wurde, wird der Schnittstellenraum zugewiesen, und die Funktion verwendet das PnP-Geräteobjekt, um die Busreferenzierungsschnittstelle 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