midiOutGetDevCaps(A)

midiOutGetDevCaps(A)

지정되었다 MIDI 출력 디바이스의 능력을 취득합니다.

MMRESULT midiOutGetDevCapsA(
    UINT_PTR     uDeviceID,    // 디바이스ID
    PMIDIOUTCAPS pMidiOutCaps, // 구조체 주소
    UINT         cbMidiOutCaps // 구조체 사이즈
);

WINMM.DLL

인수

uDeviceID

MIDI 출력 디바이스의 ID (을)를 지정합니다. 0 (으)로부터, 존재한다 MIDI 출력 디바이스의 수부터 1 적은 값까지의 사이의 수가 됩니다.또, MIDI Mapper (을)를 지정하는데, 디바이스 ID (으)로서 -1 (MIDI_MAPPER) (을)를 지정할 수 있습니다.

이 인수에, 유효한 디바이스 핸들을 지정할 수도 있습니다.

pMidiOutCaps

MIDIOUTCAPS 구조체의 주소를 지정합니다.이 구조체에, 디바이스의 능력에 관한 정보가 격납됩니다.

cbMidiOutCaps

MIDIOUTCAPS 구조체의 사이즈를 아르바이트 단위로 지정합니다.이 파라미터로 지정된 사이즈 만큼의 정보만이 pMidiOutCaps 파라미터로 지정된 구조체에 격납됩니다.이 파라미터에 0 (을)를 지정했을 경우에는, 정보를 아무것도 격납하지 않고 0 (MMSYSERR_NOERROR) (을)를 돌려줍니다.

반환값

함수가 성공하면 0 (MMSYSERR_NOERROR) 하지만 돌아갑니다.

함수가 실패하면, 이하의 에러가 돌아갑니다.

치	의미
2 (MMSYSERR_BADDEVICEID)	지정된 디바이스 ID (은)는 범위외입니다.
6 (MMSYSERR_NODRIVER)	드라이버가 인스톨 되고 있지 않습니다.
7 (MMSYSERR_NOMEM)	메모리의 확보 또는 락에 실패했습니다.
11 (MMSYSERR_INVALPARAM)	지정된 포인터 또는 구조체는 무효입니다.

해설

시스템에 존재한다 MIDI 출력 디바이스의 수를 취득하려면 , midiOutGetNumDevs 함수를 사용합니다.

대응 정보

Windows 95 이후 / Windows NT 3.1 이후