KSPROPERTY_AUDIO_POSITION

Article
06/15/2023

La propriété KSPROPERTY_AUDIO_POSITION spécifie les positions actuelles des curseurs de lecture et d’écriture dans la mémoire tampon audio du flux audio de l’épingle.

Tableau récapitulatif de l’utilisation

Obtenir	Définissez	Cible	Type de descripteur de propriété	Type de valeur de propriété
Oui	Oui	Épingle	KSPROPERTY	KSAUDIO_POSITION

La valeur de propriété (données d’opération) est une structure de type KSAUDIO_POSITION qui spécifie les positions de lecture et d’écriture d’un flux de rendu ou les positions d’enregistrement et de lecture d’un flux de capture.

Valeur de retour

Une demande de propriété KSPROPERTY_AUDIO_POSITION retourne STATUS_SUCCESS pour indiquer qu’elle s’est terminée avec succès. Sinon, la requête retourne une erreur appropriée status code.

Notes

DirectSound utilise la propriété KSPROPERTY_AUDIO_POSITION pour implémenter les méthodes IDirectSoundBuffer::GetCurrentPosition et IDirectSoundBuffer::SetCurrentPosition . Les fonctions multimédias Windows waveInGetPosition et waveOutGetPosition utilisent également cette propriété. Pour plus d’informations sur DirectSound et les fonctions multimédias Windows, consultez la documentation Microsoft Windows SDK.

Les pilotes de miniport WaveCyclique et WavePci n’ont pas besoin d’implémenter des gestionnaires de propriétés pour KSPROPERTY_AUDIO_POSITION, car les pilotes de port WaveCyclique et WavePci gèrent cette propriété pour le compte des pilotes miniport. Pour obtenir la position de lecture dans un flux de rendu ou une position d’enregistrement dans un flux de capture, le gestionnaire de propriétés dans le pilote de port appelle la méthode IMiniportWaveCycliqueStream::GetPosition ou IMiniportWavePciStream::GetPosition du pilote miniport.

Pour plus d’informations, consultez Audio Position Property.