共用方式為


KsSetTargetDeviceObject 函式 (ks.h)

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

要求

要求 價值
目標平臺 普遍
標頭 ks.h (包括 Ks.h)
連結庫 Ks.lib

另請參閱

KsAllocateDeviceHeader

KsAllocateObjectHeader

KsRecalculateStackDepth

KsSetDevicePnpAndBaseObject