IMXF::P utMessage 메서드(dmusicks.h)
PutMessage 메서드는 DMUS_KERNEL_EVENT 구조를 다음 대상으로 전달합니다. 미니포트 드라이버는 이 메서드를 사용하여 할당자가 재활용할 수 있도록 사용된 이벤트 구조를 삭제합니다.
Syntax
구문
NTSTATUS PutMessage(
PDMUS_KERNEL_EVENT pDMKEvt
);
매개 변수
pDMKEvt
대상에 전달되는 DMUS_KERNEL_EVENT 구조체에 대한 포인터입니다.
반환 값
이 메서드는 호출이 성공한 경우 STATUS_SUCCESS 포함하는 NTSTATUS를 반환합니다. 그렇지 않으면 메서드는 적절한 오류 코드를 반환합니다.
설명
렌더링하는 동안 미니포트 드라이버는 PutMessage 메서드를 호출하여 사용된 DMUS_KERNEL_EVENT 구조를 삭제합니다. 메서드는 재사용을 위해 삭제된 구조를 할당자로 라우팅합니다. 미니포트 드라이버는 렌더링을 위해 구조체에서 MIDI 데이터를 추출한 후 이 메서드를 호출합니다.
MIDI 캡처 중에 이 메서드는 MIDI 전송 그림과 같이 MIDI 메시지를 패키지하고 DMus 포트 드라이버의 캡처 싱크에 전달하는 데 사용됩니다. 이러한 메시지는 단일, 다중 또는 단편적인 MIDI 이벤트일 수 있으며 DMUS_KERNEL_EVENT 구조로 패키지됩니다(IAllocatorMXF::GetMessage 호출에 의해 검색됨).
할당자는 항상 모든 체인의 마지막 대상이므로 모든 DMUS_KERNEL_EVENT 구조가 결국 재활용됩니다. IMXF::ConnectOutput이 호출되지 않은 경우 PutMessage는 기본적으로 구조체를 할당자에 전달합니다. 자세한 내용은 할당자를 참조하세요.
요구 사항
요구 사항 | 값 |
---|---|
헤더 | dmusicks.h |
IRQL | DISPATCH_LEVEL |