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
Requisito | Valor |
---|---|
Plataforma de Destino | Área de Trabalho |
Cabeçalho | dmusicks.h (inclua Dmusicks.h) |
IRQL | <=DISPATCH_LEVEL |