Funzione KsGateCaptureThreshold (ks.h)
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 |