Interfaccia IAllocatorMXF (dmusicks.h)

L'interfaccia gestisce l'archiviazione IAllocatorMXF buffer per i flussi DirectMusic. Il driver di porta DMus implementa questa interfaccia e la espone al driver miniport DMus. Il driver di porta DMus crea un IAllocatorMXF oggetto e passa un puntatore a questo oggetto al metodo IMiniportDMus::NewStream del driver DMus miniport. IAllocatorMXF eredita dall'interfaccia IMXF .

IAllocatorMXF è l'interfaccia tramite cui il driver miniport comunica con l'allocatore interno del driver di porta, che alloca e gestisce il riutilizzo di un pool di strutture DMUS_KERNEL_EVENT . Ogni struttura può contenere un evento MIDI con timestamp.

L'allocatore astrae anche l'allocazione della memoria aggiuntiva necessaria per archiviare eventi di grandi dimensioni. Il membro uData di DMUS_KERNEL_EVENT è un'unione che corrisponde alle dimensioni di un puntatore: quattro byte in un sistema a 32 bit e otto byte in un sistema a 64 bit. Se i dati sono sufficientemente piccoli da adattarsi a tale spazio, uData conterrà i dati MIDI effettivi. Se i dati per tale evento sono maggiori del puntatore a 4 o 8 byte, tuttavia, il membro cbEvent indica questo fatto e uData contiene un puntatore a un buffer anziché i dati MIDI effettivi. Questo buffer viene gestito dall'allocatore ed è una dimensione costante per qualsiasi implementazione del driver di porta.

Ereditarietà

L'interfaccia IAllocatorMXF eredita dall'interfaccia IUnknown . IAllocatorMXF include anche questi tipi di membri:

Metodi

L'interfaccia IAllocatorMXF include questi metodi.

IAllocatorMXF::GetBuffer Il metodo GetBuffer alloca un buffer per eventi MIDI lunghi.
IAllocatorMXF::GetBufferSize Il metodo GetBufferSize ottiene le dimensioni del buffer dall'allocatore.
IAllocatorMXF::GetMessage 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.
IAllocatorMXF::P utBuffer Questo metodo non è attualmente utilizzato dal driver miniport. Il metodo PutBuffer passa un buffer all'allocatore, ma questo avviene automaticamente quando IMXF::P utMessage viene comunque chiamato.

Requisiti

Requisito	Valore
Piattaforma di destinazione	Windows
Intestazione	dmusicks.h