Método IAllocatorMXF::GetMessage (dmusicks.h)

O GetMessage método serve como o ponto de recuperação para qualquer componente do modo kernel DirectMusic que utiliza o alocador do driver de porta para reutilizar estruturas de DMUS_KERNEL_EVENT .

Sintaxe

NTSTATUS GetMessage(
  [out] PDMUS_KERNEL_EVENT *ppDMKEvt
);

Parâmetros

[out] ppDMKEvt

Ponteiro de saída para o evento MIDI. Esse parâmetro aponta para uma variável de ponteiro alocada pelo chamador na qual o método grava um ponteiro para a estrutura de eventos que está sendo recuperada do alocador. A estrutura em si está vazia (zerado pelo alocador).

Retornar valor

GetMessage retornará S_OK se a chamada tiver sido bem-sucedida. Caso contrário, o método retorna um código de erro apropriado.

Comentários

O driver de miniporto usa o GetMessage método para recuperar estruturas de eventos para renderização e captura MIDI. Esse método recupera DMUS_KERNEL_EVENT estruturas do mesmo pool em que IMXF::P utMessage as coloca quando as descarta para o alocador.

No caso de um fluxo de captura MIDI, o driver de porta recupera eventos de captura do driver de miniporto quando solicitado pelo DPC de Serviço usual.

Para obter mais informações sobre o alocador, consulte Allocator.

Requisitos

Confira também

DMUS_KERNEL_EVENT

IAllocatorMXF

IMXF::P utMessage