KSPROPERTY_AUDIO_POSITIONEX
Die eigenschaft KSPROPERTY_AUDIO_POSITIONEX stellt dem Aufrufer die Streamposition und die zugehörigen Zeitstempelinformationen für einen Kernelstreamingtreiber (KS) bereit.
Nutzungszusammenfassungstabelle
| Herunterladen | Set | Ziel | Eigenschaftendeskriptortyp | Eigenschaftswerttyp |
|---|---|---|---|---|
Ja |
Nein |
Pin |
Der Eigenschaftswert (Vorgangsdaten) ist eine Struktur vom Typ KSAUDIO_POSITIONEX, die die Positionsinformationen vom Eigenschaftenhandler empfängt. Die Positionsinformationen, die von der KSAUDIO_POSITIONEX-Struktur angegeben werden, sind die Positionsinformationen für den vom Aufrufer ausgewählten Pin.
Rückgabewert
Die KSPROPERTY_AUDIO_POSITIONEX-Eigenschaftsanforderung gibt S_OK zurück, wenn der Aufruf erfolgreich war. Andernfalls wird der entsprechende HRESULT-Fehlercode zurückgegeben.
Bemerkungen
In der Regel müssen Audioanwendungen die aktuelle Position eines Audiodatenstroms überwachen. Diese Position wird als Byteoffset vom Anfang des Datenstroms angegeben. Es gibt zwei mögliche Interpretationen der Datenstrompositionsinformationen:
Im Fall eines Renderingstreams ist die Streamposition der Byteoffset des Audioframes, der derzeit über die digital-analogen Konverter (DACs) wiedergegeben wird.
Im Falle eines Aufnahmestreams ist die Streamposition der Byteoffset des Audioframes, der derzeit über die Analog-Digital-Konverter (ADCs) aufgezeichnet wird.
Ein Treiber, der die KSPROPERTY_AUDIO_POSITIONEX-Eigenschaft unterstützt, generiert ein Zeitstempelfenster für den Wert der Streamposition. Das Zeitstempelfenster ist das Intervall zwischen dem Zeitstempel, der erfasst wird, bevor die Streamposition bestimmt wird, und dem Zeitstempel, der nach der Bestimmung der Streamposition verwendet wird. Der Aufrufer bestimmt dann, ob er das Zeitstempelfenster verwenden kann.
Requirements (Anforderungen)
Version |
Verfügbar in Windows Vista und späteren Windows-Versionen. |
Header |
Ksmedia.h (einschließlich Ksmedia.h) |