Freigeben über


KSPROPERTY_RTAUDIO_PRESENTATION_POSITION

KSPROPERTY_RTAUDIO_PRESENTATION_POSITION gibt Datenstromdarstellungsinformationen zurück.

Nutzungszusammenfassungstabelle

Herunterladen Set Ziel Eigenschaftsdeskriptortyp Eigenschaftswerttyp

Ja

Nein

Pin

KSPROPERTY

KSAUDIO_PRESENTATION_POSITION

Der Eigenschaftsdeskriptor (instance Daten) ist eine KSPROPERTY-Struktur. Vor dem Senden der Anforderung lädt der Client die Struktur mit Werten, die die aktuelle Cursorposition im Audiodatenstrom beschreiben.

Der Eigenschaftswert ist eine KSAUDIO_PRESENTATION_POSITION-Struktur , die eine aktuelle Präsentationsposition im Audiodatenstrom darstellt.

Rückgabewert

Eine KSPROPERTY_RTAUDIO_PRESENTATION_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

Das Betriebssystem kann diese Eigenschaft in regelmäßigen Abständen vom Treiber abrufen, um aktuelle Präsentationspositionsinformationen vom Treiber abzurufen, damit die oberen Ebenen Video- oder andere Aktivitäten mit dem Audiostream synchronisieren können.

Der wert, der im u64PositionInBlocks-Member von KSAUDIO_PRESENTATION_POSITION zurückgegeben wird, sollte mit der Paketanzahl übereinstimmen, die von KSPROPERTY_RTAUDIO_PACKETCOUNT zurückgegeben wird, und der Interpretation der Paketnummer, die der Treiber an SetWritePacket übergeben hat. Mit anderen Worten, das erste Beispiel von Paket 0 ist Block 0.

Dies bedeutet nicht, dass KSPROPERTY_RTAUDIO_PACKETCOUNT und KSPROPERTY_RTAUDIO_PRESENTATION_POSITION bei gleichzeitigem Aufruf Werte zurückgeben würden, die auf dasselbe Beispiel verweisen. KSPROPERTY_RTAUDIO_PACKETCOUNT gibt Informationen zu den Beispielen zurück, die vom WaveRT-Puffer an die Hardware übertragen wurden, während KSPROPERTY_RTAUDIO_PRESENTATION_POSITION Informationen zu Stichproben zurückgibt, die an der Ausgabe des Systems angezeigt werden. Dies sind zwei unterschiedliche Informationen.

Requirements (Anforderungen)

Version

Verfügbar in Windows 10 und höheren Windows-Betriebssystemen.

Header

Ksmedia.h

Siehe auch

KSPROPSETID_RTAudio