次の方法で共有

KsReferenceBusObject 関数 (ks.h)

  • [アーティクル]

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

構文

KSDDKAPI NTSTATUS KsReferenceBusObject(
  [in] KSDEVICE_HEADER Header
);

パラメーター

[in] Header

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

戻り値

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

備考

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

必要条件

要件 価値
ターゲット プラットフォーム の 万国
ヘッダー ks.h (Ks.h を含む)
ライブラリ Ks.lib