KsSetTargetState-Funktion (ks.h)

Legt den aktivierten Zustand eines Zielgeräts fest, das dem angegebenen Objektheader zugeordnet ist.

Syntax

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

Parameter

[in] Header

Verweist auf eine Kopfzeile, die zuvor von KsAllocateDeviceHeaderzugewiesen wurde.

[in] TargetState

Enthält den neuen Status des Ziels, das diesem Objektheader zugeordnet ist. Dies kann entweder KSTARGET_STATE_DISABLED oder KSTARGET_STATE_ENABLED sein.

Rückgabewert

Nichts.

Bemerkungen

Es wird davon ausgegangen, dass ein solches Ziel mit KsSetTargetDeviceObjectfestgelegt wurde. Das Ziel ist anfänglich deaktiviert und wird beim Neuberechnen der Stapeltiefe ignoriert. Für WDM Streaming-Geräte wird dies für einen Übergang zurück zu einem Stop-Zustand aufgerufen, nachdem das Ziel aktiviert und KsRecalculateStackDepth für einen Übergang zum Acquire-Zustand verwendet wurde. Dadurch kann die Stapeltiefe minimiert werden.

Anforderungen