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	KSPROPERTY	KSAUDIO_POSITIONEX

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)

Siehe auch

KSAUDIO_POSITIONEX

KSPROPERTY