Partilhar via

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 KSSTATE tipo enumerado:

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 a menor latência para um estado De execução, sem realmente estar em um estado 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 enfileiramento de dados quando em um estado pausado.
KSSTATE_RUN O pino está transmitindo dados. Ou seja, o pino consome ou produz dados de fluxo.

Valor de retorno

Retorna NOERROR se bem-sucedido; caso contrário, retorna um código de erro.

Observações

O estado do pino fornece controle motor bruto para pinos. O controle de motor fino é feito de classe por classe com propriedades personalizadas. Por exemplo, para fazer um reprodutor de disco laser externo girar, você pode definir uma propriedade de Modo 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 todo o estado do filtro. 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
da Plataforma de Destino Área de trabalho
cabeçalho ksproxy.h (inclua Ksproxy.h)
  • Last updated on