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