Método IMiniportWaveRTOutputStream::GetOutputStreamPresentationPosition (portcls.h)

Retorna informações de apresentação de fluxo.

Sintaxe

NTSTATUS GetOutputStreamPresentationPosition(
  [out] KSAUDIO_PRESENTATION_POSITION *pPresentationPosition
);

Parâmetros

[out] pPresentationPosition

pPresentationPosition retorna uma estrutura KSAUDIO_PRESENTATION_POSITION que representa uma posição de apresentação recente no fluxo de dados de áudio. Para obter mais informações, consulte IMiniportStreamAudioEngineNode::GetStreamPresentationPosition.

Valor retornado

GetOutputStreamPresentationPosition retornará STATUS_SUCCESS se a chamada tiver sido bem-sucedida. Caso contrário, a função retornará um código de status de erro apropriado.

Comentários

O sistema operacional pode obter periodicamente essa propriedade do driver para recuperar informações de posição de apresentação recentes 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 do KSAUDIO_PRESENTATION_POSITION deve ser consistente com a contagem de pacotes retornada por GetPacketCount 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 GetPacketCount e GetOutputStreamPresentationPosition, se chamados simultaneamente, retornariam valores que se referem ao mesmo exemplo. GetPacketCount retorna informações sobre os exemplos transferidos do buffer WaveRT para o hardware, enquanto GetOutputStreamPresentationPosition retorna informações sobre amostras apresentadas na saída do sistema. São duas informações diferentes.

Requisitos

   
Cliente mínimo com suporte Disponível em Windows 10 e posterior.
Plataforma de Destino Windows
Cabeçalho portcls.h
IRQL Nível passivo

Confira também

IMiniportWaveRTOutputStream