IAllocatorMXF ::GetBuffer, méthode (dmusicks.h)
La méthode GetBuffer 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 dans la mémoire tampon.
Valeur de retour
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’elle 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 possible dans le uData membre de DMUS_KERNEL_EVENT.
La taille de la mémoire tampon peut être déterminée en appelant IAllocatorMXF ::GetBufferSize.
GetBufferSize doit être appelée une seule fois, car la taille de la mémoire tampon est constante pour toute implémentation d’allocator.
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Bureau |
| d’en-tête | dmusicks.h (include Dmusicks.h) |
| IRQL | <=DISPATCH_LEVEL |