Struttura WAVEHDR (mmeapi.h)

Articolo
03/05/2024

La struttura WAVEHDR definisce l'intestazione usata per identificare un buffer audio waveform.

Sintassi

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;

Members

lpData

Puntatore al buffer waveform.

dwBufferLength

Lunghezza, in byte, del buffer.

dwBytesRecorded

Quando l'intestazione viene usata nell'input, specifica la quantità di dati nel buffer.

dwUser

Dati utente.

dwFlags

Or bit per bit di zero o più flag. I flag seguenti sono definiti:

Nome	Descrizione
WHDR_BEGINLOOP	Questo buffer è il primo buffer in un ciclo. Questo flag viene usato solo con buffer di output.
WHDR_DONE	Impostato dal driver del dispositivo per indicare che viene completato con il buffer e lo restituisce all'applicazione.
WHDR_ENDLOOP	Questo buffer è l'ultimo buffer in un ciclo. Questo flag viene usato solo con buffer di output.
WHDR_INQUEUE	Impostato da Windows per indicare che il buffer viene accodato per la riproduzione.
WHDR_PREPARED	Impostato da Windows per indicare che il buffer è stato preparato con la funzione waveInPrepareHeader o waveOutPrepareHeader.

dwLoops

Numero di volte in cui riprodurre il ciclo. Questo membro viene usato solo con buffer di output.

lpNext

Riservato.

reserved

Riservato.

Commenti

Usare i flag WHDR_BEGINLOOP e WHDR_ENDLOOP nel membro dwFlags per specificare i blocchi di dati iniziali e finali per il ciclo. Per eseguire il ciclo su un singolo blocco, specificare entrambi i flag per lo stesso blocco. Usare il membro dwLoops nella struttura WAVEHDR per il primo blocco del ciclo per specificare il numero di volte in cui riprodurre il ciclo.

I membri lpData, dwBufferLength e dwFlags devono essere impostati prima di chiamare la funzione waveInPrepareHeader o waveOutPrepareHeader. Per entrambe le funzioni, il membro dwFlags deve essere impostato su zero.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Intestazione	mmeapi.h (includere Windows.h)

Vedi anche

Condividi tramite