KsSetTargetDeviceObject 関数 (ks.h)

[アーティクル]
08/07/2023

KsSetTargetDeviceObject 関数は、オブジェクトのターゲットデバイスオブジェクトを設定します。関数は、ターゲットデバイスを持つオブジェクトヘッダーの一覧にオブジェクトヘッダーを追加します。

構文

KSDDKAPI VOID KsSetTargetDeviceObject(
  [in]           KSOBJECT_HEADER Header,
  [in, optional] PDEVICE_OBJECT  TargetDevice
);

パラメーター

[in] Header

KsAllocateObjectHeader によって以前に割り当てられたヘッダーを指します。

[in, optional] TargetDevice

必要に応じて、基になるデバイスオブジェクトのスタックの深さを再計算するときに使用されるターゲットデバイスオブジェクトを格納します。値が NULL の場合、現在の設定はすべて削除されます。値が NULL 以外の設定の場合は、現在の設定が置き換えられます。

戻り値

なし

解説

KsSetTargetDeviceObject 関数は、呼び出し元が KsAllocateDeviceHeader 関数を使用して、基になるデバイスオブジェクトにデバイスヘッダーを以前に割り当てたものとします。デバイスヘッダーが存在すると、 KsRecalculateStackDepth 関数の今後の呼び出しが可能になり、オブジェクトが別のデバイスへの接続を介して IRP を転送し、スタックの深さを追跡する必要がある場合に、デバイスヘッダーが使用されます。

KsSetDevicePnpAndBaseObject を使用して PnP オブジェクトスタックを割り当てる場合、スタックの深さを再計算するときに、そのデバイスオブジェクトも考慮されます。