PFNKSPININITIALIZEALLOCATOR, fonction de rappel (ks.h)
Un minidriver AVStream AVStrMiniInitializeAllocator routine initialise un allocator qui sera associé à une broche.
Syntaxe
PFNKSPININITIALIZEALLOCATOR Pfnkspininitializeallocator;
NTSTATUS Pfnkspininitializeallocator(
[in] PKSPIN Pin,
[in] PKSALLOCATOR_FRAMING AllocatorFraming,
[out] PVOID *Context
)
{...}
Paramètres
[in] Pin
Pointeur vers une structure KSPIN décrivant la broche avec laquelle l’allocateur doit être associé.
[in] AllocatorFraming
Pointeur vers une structure KSALLOCATOR_FRAMING décrivant les exigences d’encadrement que l’allocateur doit utiliser.
[out] Context
Pointeur vers un contexte pour l’allocateur qui sera passé en tant que paramètre aux autres routines de cette structure. Par exemple, le pilote peut stocker des structures de trame d’épingle ou d’allocator pour référence ultérieure par les autres routines de rappel. Notez que d’autres routines pour KSALLOCATOR_DISPATCH doivent avoir au moins un moyen indirect de référencer épingle. (Par exemple, AVStrMiniAllocate doit pouvoir accéder aux informations AllocatorFraming pour épingler, et Contexte est le seul paramètre que AVStream le transmet.)
Valeur de retour
AVStrMiniInitializeAllocator doit retourner STATUS_SUCCESS ou le code d’erreur qu’il a reçu lors de la tentative de création de l’allocateur.
Remarques
Le minidriver spécifie l’adresse de cette routine dans la InitializeAllocator membre de sa structure de KSALLOCATOR_DISPATCH. Le minidriver transmet cette structure au pilote de classe dans KSPIN_DISPATCH.
Notez que les allocateurs en mode noyau ne peuvent pas allouer de trames qui pourraient éventuellement atteindre le mode utilisateur.
AVStream appelle AVStrMiniInitializeAllocator pour initialiser l’allocateur donné. Le gestionnaire de cette routine doit se préparer à gérer l’allocation de mémoire et les demandes gratuites.
Pour plus d’informations, consultez KS Allocators .
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Disponible dans Microsoft Windows XP et les systèmes d’exploitation ultérieurs et DirectX 8.0 et versions ultérieures de DirectX. |
| plateforme cible | Bureau |
| d’en-tête | ks.h (include Ks.h) |