WAVEHDR-Struktur (mmeapi.h)

Artikel
03/04/2024

Die WAVEHDR-Struktur definiert den Header, der zum Identifizieren eines Waveform-Audiopuffers verwendet wird.

Syntax

typedef struct wavehdr_tag {
  LPSTR              lpData;
  DWORD              dwBufferLength;
  DWORD              dwBytesRecorded;
  DWORD_PTR          dwUser;
  DWORD              dwFlags;
  DWORD              dwLoops;
  struct wavehdr_tag *lpNext;
  DWORD_PTR          reserved;
} WAVEHDR, *PWAVEHDR, *NPWAVEHDR, *LPWAVEHDR;

Member

lpData

Zeiger auf den Wellenformpuffer.

dwBufferLength

Länge des Puffers in Bytes.

dwBytesRecorded

Wenn der Header in der Eingabe verwendet wird, gibt an, wie viele Daten sich im Puffer befinden.

dwUser

Benutzerdaten.

dwFlags

Ein bitweiser OR mit null oder mehr Flags. Die folgenden Flags werden definiert:

Name	BESCHREIBUNG
WHDR_BEGINLOOP	Dieser Puffer ist der erste Puffer in einer Schleife. Dieses Flag wird nur mit Ausgabepuffern verwendet.
WHDR_DONE	Legen Sie vom Gerätetreiber fest, um anzugeben, dass er mit dem Puffer fertig ist und ihn an die Anwendung zurückgibt.
WHDR_ENDLOOP	Dieser Puffer ist der letzte Puffer in einer Schleife. Dieses Flag wird nur mit Ausgabepuffern verwendet.
WHDR_INQUEUE	Legen Sie von Windows fest, um anzugeben, dass der Puffer für die Wiedergabe in die Warteschlange gestellt wird.
WHDR_PREPARED	Legen Sie von Windows fest, um anzugeben, dass der Puffer mit der Funktion waveInPrepareHeader oder waveOutPrepareHeader vorbereitet wurde.

dwLoops

Anzahl der Wiedergaben der Schleife. Dieses Element wird nur mit Ausgabepuffern verwendet.

lpNext

Reserviert.

reserved

Reserviert.

Hinweise

Verwenden Sie die WHDR_BEGINLOOP- und WHDR_ENDLOOP-Flags im dwFlags-Member , um die ersten und endenden Datenblöcke für die Schleifenerstellung anzugeben. Wenn Sie eine Schleife für einen einzelnen Block ausführen möchten, geben Sie beide Flags für denselben Block an. Verwenden Sie das dwLoops-Element in der WAVEHDR-Struktur für den ersten Block in der Schleife, um die Häufigkeit der Wiedergabe der Schleife anzugeben.

Die Elemente lpData, dwBufferLength und dwFlags müssen vor dem Aufrufen der Funktion waveInPrepareHeader oder waveOutPrepareHeader festgelegt werden. (Für beide Funktionen muss der dwFlags-Member auf 0 festgelegt werden.)

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Kopfzeile	mmeapi.h (einschließlich Windows.h)

Weitere Informationen