次の方法で共有

KsReferenceBusObject 関数 (ks.h)

  • [アーティクル]

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

構文

KSDDKAPI NTSTATUS KsReferenceBusObject(
  [in] KSDEVICE_HEADER Header
);

パラメーター

[in] Header

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

戻り値

参照が成功した場合はSTATUS_SUCCESSを返します。それ以外の場合は、STATUS_INSUFFICIENT_RESOURCESなどのエラーが返されます。

注釈

この関数は、デバイス ヘッダーを使用して PnP オブジェクト スタックを追跡するフィルターによって使用されます。 これは通常、このデバイスのバスがこのような参照 (ソフトウェア デバイスなど) を必要とし、そのフィルター インスタンスの近くで KsDereferenceBusObject の呼び出しによって一致する場合に、フィルターの正常な Open で呼び出されます。 PnP デバイス スタック オブジェクトを設定するには、呼び出し元が以前に KsSetDevicePnpAndBaseObject とも呼び出されている必要があります。 これは、PnP AddDevice 関数で行われました。 オブジェクトが以前に参照されていない場合は、インターフェイス領域が割り当てられ、関数は PnP デバイス オブジェクトを使用してバス参照インターフェイスを取得します。 その後、そのインターフェイスで ReferenceDeviceObject メソッドを呼び出します。 インターフェイス自体は、デバイス ヘッダーが解放されると解放され、解放されます。

要件

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