다음을 통해 공유


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에서 메시지가 표시되면 미니포트 드라이버에서 캡처 이벤트를 검색합니다.

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

요구 사항

요구
대상 플랫폼 바탕 화면
헤더 dmusicks.h(Dmusicks.h 포함)
IRQL <=DISPATCH_LEVEL

참고 항목

DMUS_KERNEL_EVENT

IAllocatorMXF

IMXF::P utMessage