Compartilhar via


KSPROPERTY_RTAUDIO_PRESENTATION_POSITION

KSPROPERTY_RTAUDIO_PRESENTATION_POSITION retorna informações de apresentação de fluxo.

Tabela de Resumo de Uso

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

Sim

Não

Pin

KSPROPERTY

KSAUDIO_PRESENTATION_POSITION

O descritor de propriedade (dados da instância) é uma estrutura KSPROPERTY . Antes de enviar a solicitação, o cliente carrega a estrutura com valores que descrevem a posição atual do cursor no fluxo de dados de áudio.

O valor da propriedade é uma estrutura KSAUDIO_PRESENTATION_POSITION que representa uma posição de apresentação recente no fluxo de dados de áudio.

Valor retornado

Uma solicitação de propriedade KSPROPERTY_RTAUDIO_PRESENTATION_POSITION retorna STATUS_SUCCESS para indicar que foi concluída com êxito. Caso contrário, a solicitação retornará uma falha apropriada status código.

Comentários

O sistema operacional pode obter periodicamente essa propriedade do driver para recuperar informações recentes de posição da apresentação do driver, a fim de permitir que camadas superiores sincronizem vídeo ou outra atividade com o fluxo de áudio.

O valor retornado no membro u64PositionInBlocks de KSAUDIO_PRESENTATION_POSITION deve ser consistente com a contagem de pacotes retornada por KSPROPERTY_RTAUDIO_PACKETCOUNT e a interpretação do driver do número do pacote passado para SetWritePacket. Em outras palavras, o primeiro exemplo do pacote 0 é o bloco 0.

Isso não significa que KSPROPERTY_RTAUDIO_PACKETCOUNT e KSPROPERTY_RTAUDIO_PRESENTATION_POSITION, se chamado simultaneamente, retornariam valores que se referem à mesma amostra. KSPROPERTY_RTAUDIO_PACKETCOUNT retorna informações sobre os exemplos transferidos do buffer WaveRT para o hardware, enquanto KSPROPERTY_RTAUDIO_PRESENTATION_POSITION retorna informações sobre amostras apresentadas na saída do sistema. São duas informações diferentes.

Requisitos

Versão

Disponível em sistemas operacionais Windows Windows 10 e posteriores.

Cabeçalho

Ksmedia.h

Confira também

KSPROPSETID_RTAudio