waveInOpen 함수(mmeapi.h)

waveInOpen 함수는 녹음을 위해 지정된 파형 오디오 입력 디바이스를 엽니다.

구문

MMRESULT waveInOpen(
  LPHWAVEIN       phwi,
  UINT            uDeviceID,
  LPCWAVEFORMATEX pwfx,
  DWORD_PTR       dwCallback,
  DWORD_PTR       dwInstance,
  DWORD           fdwOpen
);

매개 변수

phwi

열린 파형 오디오 입력 디바이스를 식별하는 핸들을 수신하는 버퍼에 대한 포인터입니다. 다른 파형 오디오 입력 함수를 호출할 때 이 핸들을 사용하여 디바이스를 식별합니다. fdwOpen에 대해 WAVE_FORMAT_QUERY 지정한 경우 이 매개 변수는 NULL일 수 있습니다.

uDeviceID

열 파형 오디오 입력 디바이스의 식별자입니다. 디바이스 식별자 또는 열린 파형 오디오 입력 디바이스의 핸들일 수 있습니다. 디바이스 식별자 대신 다음 플래그를 사용할 수 있습니다.

pwfx

파형 오디오 데이터를 기록하는 데 필요한 형식을 식별하는 WAVEFORMATEX 구조체에 대한 포인터입니다. waveInOpen이 반환된 직후에 이 구조를 해제할 수 있습니다.

dwCallback

고정 콜백 함수, 이벤트 핸들, 창에 대한 핸들 또는 파형 오디오 녹음 중에 호출될 스레드의 식별자에 대한 포인터로 기록 진행률과 관련된 메시지를 처리합니다. 콜백 함수가 필요하지 않은 경우 이 값은 0일 수 있습니다. 콜백 함수에 대한 자세한 내용은 waveInProc을 참조하세요.

dwInstance

콜백 메커니즘에 전달된 사용자 instance 데이터입니다. 이 매개 변수는 창 콜백 메커니즘에 사용되지 않습니다.

fdwOpen

디바이스를 열기 위한 플래그입니다. 다음 값이 정의됩니다.

반환 값

성공하면 MMSYSERR_NOERROR 반환하고, 그렇지 않으면 오류를 반환합니다. 가능한 오류 값은 다음과 같습니다.

설명

waveInGetNumDevs 함수를 사용하여 시스템에 있는 파형 오디오 입력 디바이스의 수를 확인합니다. uDeviceID로 지정된 디바이스 식별자는 존재하는 디바이스 수보다 0개에서 1개까지 다양합니다. WAVE_MAPPER 상수를 디바이스 식별자로 사용할 수도 있습니다.

창 또는 스레드가 콜백 정보를 수신하도록 선택하는 경우 다음 메시지가 창 프로시저 또는 스레드로 전송되어 파형 오디오 입력의 진행률을 나타냅니다. MM_WIM_OPEN, MM_WIM_CLOSE 및 MM_WIM_DATA.

함수가 콜백 정보를 수신하도록 선택하는 경우 다음 메시지가 함수로 전송되어 파형 오디오 입력의 진행률을 나타냅니다. WIM_OPEN, WIM_CLOSE 및 WIM_DATA.

요구 사항

참고 항목

파형 오디오

파형 함수