IPreFetchOffset::SetPreFetchOffset-Methode (portcls.h)

Artikel
02/26/2024

Die SetPreFetchOffset -Methode legt den Prefetch-Offset fest, d. h. die Anzahl der Datenbytes, die den Schreibcursor vom Wiedergabecursor in einem DirectSound-Ausgabestream trennen.

Syntax

void SetPreFetchOffset(
  [in] ULONG PreFetchOffset
);

Parameter

[in] PreFetchOffset

Gibt die Größe des Prefetch-Offsets in Bytes an.

Rückgabewert

Keine

Bemerkungen

Ein WavePci-Miniporttreiber ruft die SetPreFetchOffset -Methode auf, um den Prefetch-Offset eines hardwarebeschleunigten DirectSound-Ausgabestreams anzugeben.

Der Prefetch-Offset ist die Anzahl von Datenbytes, die den Schreibcursor vom Wiedergabecursor im Hardwarepuffer des Audiogeräts trennen:

Der Schreibcursor gibt die Pufferposition an, in die eine DirectSound-Anwendung das nächste Soundbeispiel sicher schreiben kann.
Der Wiedergabecursor gibt die Pufferposition des Soundbeispiels an, das derzeit vom Audiogerät wiedergegeben wird.

Weitere Informationen zu Schreibcursors und Wiedergabecursors finden Sie unter KSAUDIO_POSITION.

Informationen zur Verwendung SetPreFetchOffset zum Steuern des Prefetch-Offsets eines DirectSound-Streams finden Sie unter Prefetch Offsets.