KSPROPERTY_AUDIO_POSITIONEX
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 |
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) |