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 |