IMiniportWavePciStream ::GetPosition, méthode (portcls.h)
La méthode GetPosition obtient la position actuelle du flux.
Syntaxe
NTSTATUS GetPosition(
[out] PULONGLONG Position
);
Paramètres
[out] Position
Pointeur de sortie pour la valeur de position. Ce paramètre pointe vers une variable ULONGLONG allouée par l’appelant dans laquelle la méthode écrit la position d’octet actuelle du flux.
Valeur de retour
GetPosition retourne STATUS_SUCCESS si l’appel a réussi. Sinon, la méthode retourne un code d’erreur approprié.
Remarques
La position indiquée par la méthode GetPosition est exprimée sous la forme d’un décalage d’octets par rapport au début du flux. Il représente la meilleure estimation du pilote miniport de la position d’octet des données actuellement dans la DAC ou l’ADC. L’objet miniport est requis pour conserver la position du flux en fonction des mappages qu’il acquiert, que les mappages soient libérés ou révoqués.
La position est égale à zéro immédiatement après l’initialisation du flux. Une transition vers l’état KSSTATE_STOP (voir KSSTATE) réinitialise la position à zéro. Lorsque le flux est arrêté par une transition de KSSTATE_RUN à KSSTATE_PAUSE ou KSSTATE_ACQUIRE, la position se bloque. Il n’est pas rare lorsque le flux passe de KSSTATE_PAUSE ou de KSSTATE_ACQUIRE à KSSTATE_RUN.
La position signalée par GetPosition n’est pas un décalage dans une mémoire tampon physique que votre pilote a allouée ou qu’un client a alloué. Au lieu de cela, le décalage est relatif au flux et peut être considéré comme un décalage dans une mémoire tampon idéalisée qui contient l’ensemble du flux et qui est contigu entre le début et la fin. Tous les décalages internes qui pointent vers les mémoires tampons physiques réelles qui contiennent les données doivent être conservés séparément.
Notez que la valeur de décalage récupérée par un appel GetPosition est l’une des suivantes :
-
Pour un flux de rendu, la méthode
GetPositionrécupère la position de lecture , qui est le décalage d’octet de l’échantillon actuellement lu par le biais de la DAC et transmis par le biais de la prise de haut-parleur. -
Pour un flux de capture, la méthode
GetPositionrécupère la position d’enregistrement , qui est le décalage d’octet de l’échantillon le plus récent à recevoir par le biais de la prise de microphone et capturé par le contrôleur de domaine ADC.
Certains matériels audio contiennent un registre de position pour suivre le décalage d’octet de l’exemple actuellement dans chaque DAC ou ADC, auquel cas la méthode GetPosition récupère simplement le contenu du registre de position pour le flux approprié. D’autres matériels audio peuvent uniquement fournir au pilote des pointeurs DMA dans les mémoires tampons audio, auquel cas la méthode GetPosition doit fournir une estimation optimale du décalage d’octet dans la DAC ou ADC en fonction de la position DMA actuelle et des retards de mise en mémoire tampon internes à l’appareil.
Le matériel audio qui met en mémoire tampon en interne une partie d’un flux de lecture ou de capture peut rendre la lecture précise plus difficile à obtenir. Dans ce cas, le pilote doit estimer la position actuelle aussi précisément que possible. Par exemple, si un périphérique audio préréfète le flux de lecture dans une mémoire tampon interne, le pilote peut avoir besoin de prendre en compte à la fois la taille de la mémoire tampon et les informations de minutage afin d’estimer correctement la position de lecture.
Le pilote de port WavePci implémente un gestionnaire de propriétés pour KSPROPERTY_AUDIO_POSITION. Ce gestionnaire de propriétés appelle la méthode GetPosition pour obtenir la position de lecture ou d’enregistrement actuelle du pilote miniport. Pour plus d’informations, consultez propriété de position audio.
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Universel |
| d’en-tête | portcls.h (include Portcls.h) |
| IRQL | PASSIVE_LEVEL |