KsSetTargetDeviceObject 函式 (ks.h)

發行項
02/29/2024

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 物件堆疊，則重新計算堆疊深度時也會考慮該裝置物件。