Metodo IAllocatorMXF::GetMessage (dmusicks.h)
Il GetMessage metodo funge da punto di recupero per qualsiasi componente in modalità kernel DirectMusic che usa l'allocatore del driver di porta per riutilizzare le strutture DMUS_KERNEL_EVENT .
Sintassi
NTSTATUS GetMessage(
[out] PDMUS_KERNEL_EVENT *ppDMKEvt
);
Parametri
[out] ppDMKEvt
Puntatore di output per l'evento MIDI. Questo parametro punta a una variabile di puntatore allocata del chiamante in cui il metodo scrive un puntatore alla struttura eventi recuperata dall'allocatore. La struttura stessa è vuota (zero dall'allocatore).
Valore restituito
GetMessage restituisce S_OK se la chiamata ha esito positivo. In caso contrario, il metodo restituisce un codice di errore appropriato.
Commenti
Il driver miniport usa il metodo per recuperare strutture di eventi per il rendering e l'acquisizione GetMessage MIDI. Questo metodo recupera DMUS_KERNEL_EVENT strutture dallo stesso pool in cui IMXF::P utMessage li inserisce quando li elimina all'allocatore.
Nel caso di un flusso di acquisizione MIDI, il driver della porta recupera gli eventi di acquisizione dal driver miniport quando richiesto dal servizio DPC consueto.
Per altre informazioni sull'allocatore, vedere Allocator.
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Desktop |
| Intestazione | dmusicks.h (include Dmusicks.h) |
| IRQL | <=DISPATCH_LEVEL |