Função KsGateGetStateUnsafe (ks.h)

A função KsGateGetStateUnsafe retorna o estado do portão fornecido (aberto ou fechado) de maneira não segura, ou seja, sem considerar a sincronização.

Sintaxe

BOOLEAN KsGateGetStateUnsafe(
  [in] PKSGATE Gate
);

Parâmetros

[in] Gate

Um ponteiro para uma estrutura KSGATE que representa o portão para o qual retornar o estado.

Retornar valor

Essa chamada retornará TRUE se o portão estiver aberto e FALSE se o portão estiver fechado.

Comentários

Como KsGateGetStateUnsafe não manipula a sincronização, é possível obter um resultado que não seja consistente com o estado do portão se o portão estiver no meio da transição de um estado para outro no momento da chamada.

Considere uma situação em que a saída do portão A está conectada como uma entrada para o portão B. Um faz a transição para fechado, fazendo com que B faça a transição de aberto para fechado. Se, ao mesmo tempo, outro thread chamar KsGateGetStateUnsafe entre o momento em que A fechar e a hora em que B for fechado, a rotina ainda retornará que B estava aberto.

KsGateGetStateUnsafe retorna se Gate-Count> é maior que zero. A função não usa funções interligadas para fazer isso. Portanto, a chamada é executada sem considerar a sincronização.

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