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 |