다음을 통해 공유

WAVEHDR 구조체(mmeapi.h)

  • 아티클

WAVEHDR 구조체는 파형 오디오 버퍼를 식별하는 데 사용되는 헤더를 정의합니다.

구문

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;

멤버

lpData

파형 버퍼에 대한 포인터입니다.

dwBufferLength

버퍼의 길이(바이트)입니다.

dwBytesRecorded

헤더가 입력에 사용되는 경우 는 버퍼에 있는 데이터의 양을 지정합니다.

dwUser

사용자 데이터.

dwFlags

0개 이상의 플래그의 비트 OR 입니다. 다음 플래그가 정의됩니다.

Name Description
WHDR_BEGINLOOP
 이 버퍼는 루프의 첫 번째 버퍼입니다. 이 플래그는 출력 버퍼에서만 사용됩니다.
WHDR_DONE
 디바이스 드라이버가 버퍼로 완료되고 애플리케이션에 반환됨을 나타내도록 설정합니다.
WHDR_ENDLOOP
 이 버퍼는 루프의 마지막 버퍼입니다. 이 플래그는 출력 버퍼에서만 사용됩니다.
WHDR_INQUEUE
 버퍼가 재생 대기 중임을 나타내기 위해 Windows에서 설정합니다.
WHDR_PREPARED
 버퍼가 waveInPrepareHeader 또는 waveOutPrepareHeader 함수로 준비되었음을 나타내기 위해 Windows에서 설정합니다.

dwLoops

루프를 재생할 횟수입니다. 이 멤버는 출력 버퍼에서만 사용됩니다.

lpNext

예약되어 있습니다.

reserved

예약되어 있습니다.

설명

dwFlags 멤버의 WHDR_BEGINLOOP 및 WHDR_ENDLOOP 플래그를 사용하여 루핑을 위한 시작 및 끝 데이터 블록을 지정합니다. 단일 블록에서 반복하려면 동일한 블록에 대해 두 플래그를 모두 지정합니다. 루프의 첫 번째 블록에 대해 WAVEHDR 구조체의 dwLoops 멤버를 사용하여 루프를 재생할 횟수를 지정합니다.

waveInPrepareHeader 또는 waveOutPrepareHeader 함수를 호출하기 전에 lpData, dwBufferLength 및 dwFlags 멤버를 설정해야 합니다. 두 함수의 경우 dwFlags 멤버를 0으로 설정해야 합니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버 Windows 2000 Server[데스크톱 앱만]
머리글 mmeapi.h(Windows.h 포함)

추가 정보

파형 오디오

파형 구조체

waveInPrepareHeader

waveOutPrepareHeader