waveOutGetDevCapsA 함수는 지정된 파형 오디오 출력 디바이스의 기능을 검색합니다. 함수의 ANSI 버전입니다.
Syntax
MMRESULT waveOutGetDevCapsA(
UINT_PTR uDeviceID,
LPWAVEOUTCAPSA pwoc,
UINT cbwoc
);
매개 변수
uDeviceID
파형 오디오 출력 디바이스의 식별자입니다. 디바이스 식별자 또는 열린 파형 오디오 출력 디바이스의 핸들일 수 있습니다.
pwoc
디바이스의 기능에 대한 정보로 채울 WAVEOUTCAPSA 구조체에 대한 포인터입니다.
cbwoc
WAVEOUTCAPSA 구조체의 크기(바이트)입니다.
반환 값
성공하거나 오류가 발생하면 MMSYSERR_NOERROR 반환합니다. 가능한 오류 값은 다음과 같습니다.
| 반환 코드 | Description |
|---|---|
| MMSYSERR_BADDEVICEID | 지정된 디바이스 식별자가 범위를 벗어났습니다. |
| MMSYSERR_NODRIVER | 디바이스 드라이버가 없습니다. |
| MMSYSERR_NOMEM | 메모리를 할당하거나 잠글 수 없습니다. |
비고
waveOutGetNumDevs 함수를 사용하여 시스템에 있는 파형 오디오 출력 디바이스의 수를 확인합니다. uDeviceID 매개 변수에 의해 지정된 값이 디바이스 식별자인 경우 0에서 1로 변경될 수 있습니다. WAVE_MAPPER 상수는 디바이스 식별자로도 사용할 수 있습니다. 정보의 cbwoc 바이트(이하)만 pwoc가 가리키는 위치에 복사됩니다. cbwoc가 0이면 아무것도 복사되지 않으며 함수는 0을 반환합니다.
요구 사항
| 요구 사항 | 가치 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 2000 Professional |
| 지원되는 최소 서버 | 윈도우 2000 서버 |
| Header | mmeapi.h |
| Library | Winmm.lib |
| DLL | Winmm.dll |