KSPROPERTY_AUDIO_POSITION

Artikel
06/15/2023

Die KSPROPERTY_AUDIO_POSITION-Eigenschaft gibt die aktuelle Position der Wiedergabe- und Schreibcursoren im Soundpuffer für den Audiostream des Pins an.

Nutzungszusammenfassungstabelle

Herunterladen	Set	Ziel	Eigenschaftsdeskriptortyp	Eigenschaftswerttyp
Ja	Ja	Pin	KSPROPERTY	KSAUDIO_POSITION

Der Eigenschaftswert (Vorgangsdaten) ist eine Struktur vom Typ KSAUDIO_POSITION, die die Wiedergabe- und Schreibpositionen eines Renderdatenstroms oder die Datensatz- und Lesepositionen eines Aufzeichnungsdatenstroms angibt.

Rückgabewert

Eine KSPROPERTY_AUDIO_POSITION-Eigenschaftsanforderung gibt STATUS_SUCCESS zurück, um anzugeben, dass sie erfolgreich abgeschlossen wurde. Andernfalls gibt die Anforderung einen entsprechenden Fehler status Code zurück.

Bemerkungen

DirectSound verwendet die KSPROPERTY_AUDIO_POSITION-Eigenschaft, um die Methoden IDirectSoundBuffer::GetCurrentPosition und IDirectSoundBuffer::SetCurrentPosition zu implementieren. Diese Eigenschaft verwenden auch die Windows-Multimediafunktionen waveInGetPosition und waveOutGetPosition . Weitere Informationen zu DirectSound und den Multimediafunktionen von Windows finden Sie in der Microsoft Windows SDK-Dokumentation.

WaveCyclic- und WavePci-Miniporttreiber müssen keine Eigenschaftenhandler für KSPROPERTY_AUDIO_POSITION implementieren, da die WaveCyclic- und WavePci-Porttreiber diese Eigenschaft im Auftrag von Miniporttreibern verarbeiten. Um die Wiedergabeposition in einem Renderdatenstrom oder einer Datensatzposition in einem Aufzeichnungsdatenstrom abzurufen, ruft der Eigenschaftenhandler im Porttreiber die IMiniportWaveCyclicStream::GetPosition - oder IMiniportWavePciStream::GetPosition-Methode des Miniporttreibers auf.

Weitere Informationen finden Sie unter Eigenschaft "Audioposition".