Compartilhar via


KSPROPERTY_AUDIO_POSITION

A propriedade KSPROPERTY_AUDIO_POSITION especifica as posições atuais dos cursores de reprodução e gravação no buffer de som para o fluxo de áudio do pino.

Tabela de Resumo de Uso

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

Sim

Sim

Pin

KSPROPERTY

KSAUDIO_POSITION

O valor da propriedade (dados de operação) é uma estrutura do tipo KSAUDIO_POSITION que especifica as posições de reprodução e gravação de um fluxo de renderização ou as posições de gravação e registro de um fluxo de captura.

Valor retornado

Uma solicitação de propriedade KSPROPERTY_AUDIO_POSITION retorna STATUS_SUCCESS para indicar que foi concluída com êxito. Caso contrário, a solicitação retornará um erro apropriado status código.

Comentários

O DirectSound usa a propriedade KSPROPERTY_AUDIO_POSITION para implementar os métodos IDirectSoundBuffer::GetCurrentPosition e IDirectSoundBuffer::SetCurrentPosition . As funções multimídia do Windows waveInGetPosition e waveOutGetPosition também usam essa propriedade. Para obter mais informações sobre o DirectSound e as funções multimídia do Windows, consulte a documentação do SDK do Microsoft Windows.

Os drivers de miniporta WaveCyclic e WavePci não precisam implementar manipuladores de propriedade para KSPROPERTY_AUDIO_POSITION porque os drivers de porta WaveCyclic e WavePci lidam com essa propriedade em nome de drivers de miniporta. Para obter a posição de reprodução em um fluxo de renderização ou posição de registro em um fluxo de captura, o manipulador de propriedades no driver de porta chama o método IMiniportWaveCyclicStream::GetPosition ou IMiniportWavePciStream::GetPosition do driver de miniport.

Para obter mais informações, consulte Propriedade Audio Position.

Requisitos

parâmetro

Ksmedia.h (inclua Ksmedia.h)

Confira também

KSPROPERTY

KSAUDIO_POSITION

IMiniportWaveCyclicStream::GetPosition

IMiniportWavePciStream::GetPosition