IMiniportWaveCycliqueStream ::GetPosition, méthode (portcls.h)
La méthode GetPosition obtient la position actuelle du flux.
Syntaxe
NTSTATUS GetPosition(
[out] PULONG Position
);
Paramètres
[out] Position
Pointeur de sortie pour la valeur de position. Ce paramètre pointe vers une variable 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
GetPosition signale la position de lecture ou d’enregistrement actuelle du flux. La position est exprimée sous la forme d’un décalage d’octets par rapport au début de la mémoire tampon DMA et représente la meilleure estimation du pilote miniport de la position d’octet des données actuellement dans la DAC ou ADC.
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.
GetPosition spécifie la position en tant que décalage dans la mémoire tampon cyclique. Lorsque la position atteint la fin de la mémoire tampon cyclique, elle s’encapsule au début de la mémoire tampon. Par conséquent, la position ne dépasse jamais la taille de la mémoire tampon.
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 en cours de lecture par le biais de la DAC et transmise par le biais de la prise du 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ée par l’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 WaveCyclique 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 | <=DISPATCH_LEVEL |