KsDereferenceBusObject 関数 (ks.h)

バス物理デバイス オブジェクトを逆参照します。

構文

KSDDKAPI VOID KsDereferenceBusObject(
  [in] KSDEVICE_HEADER Header
);

パラメーター

[in] Header

PnP デバイス スタック オブジェクトも含む KsAllocateDeviceHeader によって以前に割り当てられたヘッダーを指します。

戻り値

[なし] :

解説

これは、対応する PnP オブジェクト スタックを追跡するためにデバイス ヘッダーを使用するフィルターによって使用されます。 これは通常、特定のデバイスのバスで必要な場合に、フィルターを閉じるときに呼び出されます。 たとえば、ソフトウェア デバイスではこのような呼び出しが必要になります。 この呼び出しは、フィルター インスタンスを開くときに KsReferenceBusObject の以前の呼び出しと一致します。 PnP デバイス スタック オブジェクトを設定するには、呼び出し元が以前 に KsSetDevicePnpAndBaseObject とも呼び出されている必要があります。 これは、PnP AddDevice 関数で行われました。 関数は、前に取得したインターフェイスで DereferenceDeviceObject メソッドを呼び出します。 インターフェイス自体は、デバイス ヘッダーが解放されると解放され、解放されます。

要件

要件	値
対象プラットフォーム	ユニバーサル
Header	ks.h (Ks.h を含む)
Library	Ks.lib