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 方法。 釋放裝置標頭時，介面本身會釋出並釋放。

規格需求

需求	值
目標平台	Universal
標頭	ks.h (包含 Ks.h)
程式庫	Ks.lib