Share via

midiStreamProperty 함수(mmeapi.h)

  • 아티클

midiStreamProperty 함수는 MIDI 출력 디바이스와 연결된 MIDI 데이터 스트림의 속성을 설정하거나 검색합니다.

구문

MMRESULT midiStreamProperty(
  HMIDISTRM hms,
  LPBYTE    lppropdata,
  DWORD     dwProperty
);

매개 변수

hms

속성이 연결된 MIDI 디바이스에 대한 핸들입니다.

lppropdata

속성 데이터에 대한 포인터입니다.

dwProperty

MIDI 데이터 스트림의 적절한 속성을 수행하고 식별하는 작업을 지정하는 플래그입니다. midiStreamProperty 함수는 각 사용에서 두 개의 플래그를 설정해야 합니다. 하나의 플래그(MIDIPROP_GET 또는 MIDIPROP_SET)는 작업을 지정하고 다른 플래그는 검사하거나 편집할 특정 속성을 식별합니다.

값 의미
MIDIPROP_GET 지정된 속성의 현재 설정을 검색합니다.
MIDIPROP_SET 지정된 속성을 설정합니다.
MIDIPROP_TEMPO tempo 속성을 검색합니다. lppropdata 매개 변수는 MIDIPROPTEMPO 구조를 가리킵니다. 현재 tempo 값은 언제든지 검색할 수 있습니다. 출력 디바이스는 MIDI 데이터에 MEVT_TEMPO 이벤트를 삽입하여 tempo를 설정합니다.
MIDIPROP_TIMEDIV 시간 나누기 속성을 지정합니다. 이 속성을 얻거나 설정할 수 있습니다. lppropdata 매개 변수는 MIDIPROPTIMEDIV 구조를 가리킵니다. 이 속성은 디바이스가 중지된 경우에만 설정할 수 있습니다.

반환 값

성공하거나 오류가 있으면 MMSYSERR_NOERROR 반환합니다. 가능한 오류 값은 다음과 같습니다.

반환 코드 설명
MMSYSERR_INVALHANDLE
 지정된 핸들이 스트림 핸들이 아닙니다.
MMSYSERR_INVALPARAM
 지정된 핸들 또는 flags 매개 변수가 잘못되었습니다.

설명

이러한 속성은 시스템에서 정의한 기본 속성입니다. 드라이버 작성기는 자체 속성을 구현하고 문서화할 수 있습니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버 Windows 2000 Server[데스크톱 앱만]
대상 플랫폼 Windows
헤더 mmeapi.h(Windows.h 포함)
라이브러리 Winmm.lib
DLL Winmm.dll

추가 정보

MIDI 함수