Função KsGateCaptureThreshold (ks.h)
A função KsGateCaptureThreshold é usada para capturar uma entrada ON de uma porta AND especificada por Gate.
Sintaxe
BOOLEAN KsGateCaptureThreshold(
[in] PKSGATE Gate
);
Parâmetros
[in] Gate
Um ponteiro para uma estrutura KSGATE que representa a porta AND para a qual capturar uma entrada ON de forma síncrona.
Retornar valor
KsGateCaptureThreshold retornará TRUE se o portão AND estiver originalmente aberto. Observe que retornar TRUE implica que o portão foi fechado para que nenhum outro thread pudesse capturar simultaneamente o portão e iniciar o processamento.
Comentários
KsGateCaptureThreshold verifica o estado do portão AND especificado. Se o portão estiver aberto, ele desativará uma entrada para o portão, fazendo a transição do portão para um estado fechado. Se o portão estiver fechado, a função não fará nada. Ao contrário de KsGateGetStateUnsafe, essa chamada é feita de forma síncrona em relação a outras alterações de estado de portão. É o mecanismo de sincronização principal para processamento com base no controle de porta.
Apesar do nome, essa função é apenas uma chamada válida para portões AND, não portões em geral. O AVStream, no entanto, não verifica se Gate é um portão AND ou um portão OR. É responsabilidade do chamador garantir que a chamada seja feita apenas nos portões AND.
A chamada é feita usando funções interligadas e, portanto, é síncrona em relação a qualquer uma das outras funções de alteração de estado de portão; também é um método muito eficiente de controle de processo.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Disponível no Microsoft Windows XP e em sistemas operacionais posteriores e no DirectX 8.0 e versões posteriores do DirectX. |
| Plataforma de Destino | Área de Trabalho |
| Cabeçalho | ks.h (inclua Ks.h) |
| IRQL | Qualquer nível |