Compartilhar via


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

Confira também

KsGateAddOffInputToAnd

KsGateAddOffInputToOr

KsGateAddOnInputToAnd

KsGateAddOnInputToOr

KsGateGetStateUnsafe

KsGateInitializeAnd

KsGateInitializeOr

KsGateRemoveOffInputFromAnd

KsGateRemoveOffInputFromOr

KsGateRemoveOnInputFromAnd

KsGateRemoveOnInputFromOr

KsGateTurnInputOff

KsGateTurnInputOn