Partilhar via


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

O método GetMessage 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 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 por chamador na qual o método grava um ponteiro na estrutura de eventos que está sendo recuperada do alocador. A estrutura em si está vazia (zerado pelo alocador).

Valor de retorno

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

Observações

O driver de miniporto usa o método GetMessage para recuperar estruturas de eventos para renderização e captura MIDI. Esse método recupera DMUS_KERNEL_EVENT estruturas do mesmo pool 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 habitual.

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

Requisitos

Requisito Valor
da Plataforma de Destino Área de trabalho
cabeçalho dmusicks.h (inclua Dmusicks.h)
IRQL <=DISPATCH_LEVEL

Consulte também

DMUS_KERNEL_EVENT

IAllocatorMXF

IMXF::P utMessage