Compartilhar via

KSPROPERTY_AUDIO_POSITIONEX

  • Artigo

A propriedade KSPROPERTY_AUDIO_POSITIONEX fornece ao chamador a posição do fluxo e as informações de carimbo de data/hora associadas para um driver de áudio baseado em KS (streaming de kernel).

Tabela de Resumo de Uso

Obter Definir Destino Tipo de descritor de propriedade Tipo de valor da propriedade

Sim

Não

Pin

KSPROPERTY

KSAUDIO_POSITIONEX

O valor da propriedade (dados de operação) é uma estrutura do tipo KSAUDIO_POSITIONEX que recebe as informações de posição do manipulador de propriedades. As informações de posição especificadas pela estrutura KSAUDIO_POSITIONEX são as informações de posição do pino selecionado pelo chamador.

Valor retornado

A solicitação de propriedade KSPROPERTY_AUDIO_POSITIONEX retornará S_OK se a chamada tiver sido bem-sucedida. Caso contrário, ele retornará o código de erro HRESULT apropriado.

Comentários

Normalmente, os aplicativos de áudio devem monitorar a posição atual de um fluxo de áudio. Essa posição é especificada como um deslocamento de bytes desde o início do fluxo. Há duas interpretações possíveis das informações de posição do fluxo:

  • No caso de um fluxo de renderização, a posição do fluxo é o deslocamento de bytes do quadro de áudio que está sendo reproduzido atualmente por meio dos DACs (conversores digitais para analógicos).

  • No caso de um fluxo de captura, a posição do fluxo é o deslocamento de bytes do quadro de áudio que está sendo gravado atualmente por meio dos ADCs (conversores analógicos para digitais).

Um driver que dá suporte à propriedade KSPROPERTY_AUDIO_POSITIONEX gera uma janela de carimbo de data/hora para o valor da posição do fluxo. A janela de carimbo de data/hora é o intervalo entre o carimbo de data/hora que é amostrado antes da posição do fluxo ser determinada e o carimbo de data/hora que é obtido após a posição do fluxo ser determinada. Em seguida, o chamador determina se ele pode usar a janela de carimbo de data/hora.

Requisitos

Versão

Disponível no Windows Vista e versões posteriores do Windows.

parâmetro

 Ksmedia.h (inclua Ksmedia.h)

Confira também

KSAUDIO_POSITIONEX

KSPROPERTY