Método IKsClockPropertySet::KsGetState (ksproxy.h)

O método KsGetState recupera o estado de streaming de um pino do relógio subjacente.

Sintaxe

HRESULT KsGetState(
  [out] KSSTATE *State
);

Parâmetros

[out] State

Ponteiro para uma variável que recebe um valor que especifica o estado de streaming de um pino. Esse valor pode ser um dos seguintes valores do tipo enumerado KSSTATE :

Valor	Descrição
KSSTATE_STOP	O streaming de dados de ou para o pino é interrompido. Representa o estado inicial do pino com o menor uso de recursos e a maior latência para obter um estado KSSTATE_RUN .
KSSTATE_ACQUIRE	Representa o estado no qual os alocadores são negociados e os recursos adquiridos, embora nenhum dado possa ser armazenado em buffer nesse estado.
KSSTATE_PAUSE	O relógio está aguardando e está preparado para mudar instantaneamente para o estado KSSTATE_RUN . Representa o modo de maior uso de recursos e menor latência para um estado De execução, sem realmente estar em um estado de KSSTATE_RUN . Os dados podem ser armazenados em buffer nesse estado. Se o estado do pino for consultado e esse estado estiver em pausa no momento, o pino poderá retornar um erro de STATUS_NO_DATA_DETECTED para indicar que esse pino não executa a fila de dados quando em um estado pausado.
KSSTATE_RUN	O pino é dados de streaming. Ou seja, o pino consome ou produz dados de fluxo.

Retornar valor

Retornará NOERROR se tiver êxito; caso contrário, retorna um código de erro.

Comentários

O estado do pino fornece controle de motor bruto para pinos. O controle de motor fino é feito de classe por classe com propriedades personalizadas. Por exemplo, para fazer um player de disco laser externo girar, você pode definir uma propriedade mode personalizada específica para essa classe. Definir essa propriedade também pode alterar o estado do dispositivo, embora não necessariamente, dependendo do efeito do modo.

Um filtro em si pode dar suporte a essa propriedade de estado para que os aplicativos possam definir o estado do filtro inteiro. Caso contrário, cada pino deve ter seu estado definido. Quando o estado de um pino faz a transição de KSSTATE_STOP, cada conexão que encaminha IRPs deve recalcular a profundidade da pilha.

O proxy usa a propriedade KSPROPERTY_CLOCK_STATE para recuperar o estado de streaming de um pino.

Requisitos

Requisito	Valor
Plataforma de Destino	Área de Trabalho
Cabeçalho	ksproxy.h (inclua Ksproxy.h)