KsSetTargetState-Funktion (ks.h)

Legt den aktivierten Status 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 einen Header, der zuvor von KsAllocateDeviceHeader zugeordnet 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

Keine.

Hinweise

Es wird davon ausgegangen, dass ein solches Ziel mit KsSetTargetDeviceObject festgelegt wurde. Das Ziel ist zunächst deaktiviert und wird ignoriert, wenn die Stapeltiefe neu berechnet wird. Für WDM-Streaminggeräte wird dies bei einem Übergang zurück in den Status Beenden aufgerufen, nachdem das Ziel aktiviert und KsRecalculateStackDepth bei einem Übergang zum Zustand Abrufen verwendet wurde. Dadurch kann die Stapeltiefe minimiert werden.

Anforderungen