IAllocatorMXF::GetMessage 메서드(dmusicks.h)

메서드는 GetMessage 포트 드라이버의 할당자를 활용하여 DMUS_KERNEL_EVENT 구조를 다시 사용하는 DirectMusic 커널 모드 구성 요소의 검색 지점 역할을 합니다.

구문

NTSTATUS GetMessage(
  [out] PDMUS_KERNEL_EVENT *ppDMKEvt
);

[out] ppDMKEvt

MIDI 이벤트에 대한 출력 포인터입니다. 이 매개 변수는 메서드가 할당자에서 검색되는 이벤트 구조에 대한 포인터를 작성하는 호출자 할당 포인터 변수를 가리킵니다. 구조체 자체는 비어 있습니다(할당자에 의해 0으로 표시됨).

GetMessage 는 호출에 성공하면 S_OK 반환합니다. 그렇지 않으면 메서드는 적절한 오류 코드를 반환합니다.

미니포트 드라이버는 메서드를 GetMessage 사용하여 MIDI 렌더링 및 캡처에 대한 이벤트 구조를 검색합니다. 이 메서드는 IMXF::P utMessage가 할당자에 삭제할 때 배치하는 것과 동일한 풀에서 DMUS_KERNEL_EVENT 구조를 검색합니다.

MIDI 캡처 스트림의 경우 포트 드라이버는 일반적인 서비스 DPC에서 메시지가 표시될 때 미니포트 드라이버에서 캡처 이벤트를 검색합니다.

할당자에 대한 자세한 내용은 할당 자를 참조하세요.