KSPROPERTY_AUDIO_POSITION

Artigo
06/15/2023

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.