Funzione KsGateCaptureThreshold (ks.h)

Articolo
03/08/2023

La funzione KsGateCaptureThreshold viene usata per acquisire un input ON di un gate AND specificato da Gate.

Sintassi

BOOLEAN KsGateCaptureThreshold(
  [in] PKSGATE Gate
);

Parametri

[in] Gate

Puntatore a una struttura KSGATE che rappresenta il gate AND per cui acquisire un input ON in modo sincrono.

Valore restituito

KsGateCaptureThreshold restituisce TRUE se il gate AND era originariamente aperto. Si noti che la restituzione di TRUE implica che il gate è stato chiuso in modo che nessun altro thread possa acquisire simultaneamente il gate e iniziare l'elaborazione.

Commenti

KsGateCaptureThreshold controlla lo stato del gate AND specificato. Se il cancello è aperto, disattiva un input al cancello, passando così il cancello a uno stato chiuso. Se il gate è chiuso, la funzione non fa nulla. A differenza di KsGateGetStateUnsafe, questa chiamata viene eseguita in modo sincrono rispetto ad altre modifiche dello stato di gate. È il meccanismo di sincronizzazione principale per l'elaborazione in base al controllo gate.

Nonostante il nome, questa funzione è solo una chiamata valida per porte AND, non porte in generale. AVStream, tuttavia, non verifica se Gate è un cancello AND o un gate OR. È responsabilità del chiamante assicurarsi che la chiamata venga effettuata solo sui cancelli AND.

La chiamata viene effettuata usando funzioni interlockate ed è quindi sincrona rispetto a qualsiasi altra funzione di modifica dello stato di gate; è anche un metodo molto efficiente del controllo del processo.

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile in Microsoft Windows XP e versioni successive e DirectX 8.0 e versioni successive di DirectX.
Piattaforma di destinazione	Desktop
Intestazione	ks.h (include Ks.h)
IRQL	Qualsiasi livello