IAllocatorMXF ::GetBuffer, méthode (dmusicks.h)

La GetBuffer méthode alloue une mémoire tampon pour les événements MIDI longs.

Syntaxe

NTSTATUS GetBuffer(
  [out] PBYTE *ppBuffer
);

Paramètres

[out] ppBuffer

Pointeur de sortie pour la mémoire tampon. Ce paramètre pointe vers une variable de pointeur allouée par l’appelant dans laquelle la méthode écrit un pointeur vers la mémoire tampon.

Valeur retournée

GetBuffer retourne S_OK si l’appel a réussi. Sinon, la méthode retourne un code d’erreur approprié.

Remarques

Le pilote miniport appelle cette méthode uniquement lorsqu’il doit envoyer de gros blocs de données au récepteur de capture. Plus précisément, le pilote miniport utilise cette méthode chaque fois qu’un composant doit empaqueter plus de données que peut être stocké dans le membre uData de DMUS_KERNEL_EVENT.

La taille de la mémoire tampon peut être déterminée en appelant IAllocatorMXF ::GetBufferSize. GetBufferSize ne doit être appelée qu’une seule fois, car la taille de la mémoire tampon est constante pour toute implémentation d’allocateur.

Configuration requise

Condition requise Valeur
Plateforme cible Desktop (Expérience utilisateur)
En-tête dmusicks.h (inclure Dmusicks.h)
IRQL <=DISPATCH_LEVEL

Voir aussi

DMUS_KERNEL_EVENT

IAllocatorMXF

IAllocatorMXF ::GetBufferSize