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 |