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.

Retornar valor

GetOutputStreamPresentationPosition retornará STATUS_SUCCESS se a chamada tiver sido bem-sucedida. Caso contrário, a função retornará um erro apropriado 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 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 exemplos apresentados na saída do sistema. São duas informações diferentes.

Requisitos

Requisito	Valor
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