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 |