ksDereferenceBusObject 函式 (ks.h)

取值總線實體裝置物件。

語法

KSDDKAPI VOID KsDereferenceBusObject(
  [in] KSDEVICE_HEADER Header
);

參數

[in] Header

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

傳回值

無。

備註

這會由使用裝置標頭的篩選來追蹤對應的 PnP 物件堆疊。 如果指定裝置的總線需要，通常會在關閉篩選時呼叫此動作。 例如，軟體裝置需要這類呼叫。 此呼叫符合開啟篩選實例時對 KsReferenceBusObject 的先前呼叫。 呼叫端先前必須同時呼叫 KsSetDevicePnpAndBaseObject ，才能設定 PnP 裝置堆疊物件。 這會在 PnP AddDevice 函式中完成。 函式會在先前擷取的介面上呼叫 DereferenceDeviceObject 方法。 釋放裝置標頭時，介面本身會釋出並釋放。

規格需求

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