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

추가 정보

IMXF