KsReferenceBusObject 函式 （ks.h）

參考總線實體裝置物件。

語法

KSDDKAPI NTSTATUS KsReferenceBusObject(
  [in] KSDEVICE_HEADER Header
);

參數

[in] Header

指向先前由 KsAllocateDeviceHeader 所配置的標頭， 也包含 PnP 裝置堆棧物件。

傳回值

如果參考成功，則傳回STATUS_SUCCESS，否則傳回錯誤，例如STATUS_INSUFFICIENT_RESOURCES。

言論

此函式是由使用裝置標頭來追蹤其 PnP 物件堆疊的篩選器所使用。 當此裝置的總線需要這類參考（例如軟體裝置）時，通常會在成功的 [開啟篩選] 上呼叫此篩選器，而且會在該篩選實例接近時，比對 KsDereferenceBusObject。 呼叫端先前也必須呼叫 KsSetDevicePnpAndBaseObject，才能設定 PnP 裝置堆疊物件。 這會在 PnP AddDevice 函式中完成。 如果物件先前尚未參考，則會配置介面空間，而且函式會使用 PnP 裝置物件來取得總線參考介面。 然後，它會在該介面上呼叫 ReferenceDeviceObject 方法。 釋放裝置標頭時，介面本身會釋出並釋出。

要求