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

  • Article

Retourne des informations de présentation de flux.

Syntaxe

NTSTATUS GetOutputStreamPresentationPosition(
  [out] KSAUDIO_PRESENTATION_POSITION *pPresentationPosition
);

Paramètres

[out] pPresentationPosition

pPresentationPosition retourne une structure KSAUDIO_PRESENTATION_POSITION qui représente une position de présentation récente dans le flux de données audio. Pour plus d’informations, consultez IMiniportStreamAudioEngineNode ::GetStreamPresentationPosition.

Valeur retournée

GetOutputStreamPresentationPosition retourne STATUS_SUCCESS si l’appel a réussi. Sinon, la fonction retourne une erreur appropriée status code.

Remarques

Le système d’exploitation peut obtenir régulièrement cette propriété du pilote pour récupérer des informations récentes sur la position de la présentation à partir du pilote afin de permettre aux couches supérieures de synchroniser la vidéo ou d’autres activités avec le flux audio.

La valeur retournée dans le membre u64PositionInBlocks de KSAUDIO_PRESENTATION_POSITION doit être cohérente avec le nombre de paquets retourné par GetPacketCount et l’interprétation par le pilote du numéro de paquet passé à SetWritePacket. En d’autres termes, le premier échantillon de paquet 0 est le bloc 0.

Cela ne signifie pas que GetPacketCount et GetOutputStreamPresentationPosition, s’ils sont appelés simultanément, retournent des valeurs qui font référence au même exemple. GetPacketCount retourne des informations sur les exemples transférés de la mémoire tampon WaveRT vers le matériel, tandis que GetOutputStreamPresentationPosition retourne des informations sur les exemples présentés à la sortie du système. Il s’agit de deux éléments d’information différents.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Disponible dans Windows 10 et versions ultérieures.
Plateforme cible Windows
En-tête portcls.h
IRQL Niveau passif

Voir aussi

IMiniportWaveRTOutputStream