KsSetTargetState 函式 (ks.h)

設定與指定之對象標頭相關聯的目標裝置啟用狀態。

語法

KSDDKAPI VOID KsSetTargetState(
  [in] KSOBJECT_HEADER Header,
  [in] KSTARGET_STATE  TargetState
);

參數

[in] Header

指向先前由 KsAllocateDeviceHeader 配置的標頭。

[in] TargetState

包含與此對象標頭相關聯之目標的新狀態。 這可能是KSTARGET_STATE_DISABLED或KSTARGET_STATE_ENABLED。

傳回值

無。

備註

假設已使用 KsSetTargetDeviceObject 設定這類目標。 一開始會停用目標，並在重新計算堆疊深度時予以忽略。 對於WDM串流裝置，在啟用目標並使用 KsRecalculateStackDepth 轉換至 Acquire 狀態之後，會在轉換回 [停止] 狀態時呼叫此功能。 這可讓堆疊深度最小化。

規格需求

需求	值
目標平台	Universal
標頭	ks.h (包含 Ks.h)
程式庫	Ks.lib