PINT10_ALLOCATE_BUFFER fonction de rappel (video.h)
La fonction Int10AllocateBuffer peut être utilisée pour allouer un seul bloc de mémoire de 4 Ko dans le contexte d’un autre thread. Une fois le bloc de mémoire alloué, il doit être libéré avant qu’un autre bloc de mémoire puisse être alloué.
Syntaxe
PINT10_ALLOCATE_BUFFER Pint10AllocateBuffer;
VP_STATUS Pint10AllocateBuffer(
[in] IN PVOID Context,
[out] OUT PUSHORT Seg,
[out] OUT PUSHORT Off,
[in, out] IN OUT PULONG Length
)
{...}
Paramètres
[in] Context
Pointeur vers un contexte défini par le pilote de port vidéo pour l’interface. Il doit s’agir de la même valeur que dans le Context membre de la structure VIDEO_PORT_INT10_INTERFACE après VideoPortQueryServices retourne.
[out] Seg
Pointeur vers un emplacement de mémoire qui recevra l’adresse du segment de la mémoire tampon allouée.
[out] Off
Pointeur vers un emplacement de mémoire qui recevra le décalage dans le segment spécifié par *Seg, de la mémoire tampon allouée.
[in, out] Length
Pointeur vers un emplacement de mémoire qui contient la longueur, en octets, de la mémoire tampon demandée, qui peut être aussi grande que 4096. Lorsque la fonction retourne, cet emplacement de mémoire contient la valeur 4096, si la mémoire a été réellement allouée.
Valeur de retour
La fonction Int10AllocateBuffer retourne NO_ERROR en cas de réussite. Elle retourne STATUS_INSUFFICIENT_RESOURCES si la mémoire tampon a été allouée précédemment ou si une taille de mémoire tampon supérieure à 4096 octets est demandée.
Remarques
Le port vidéo implémente cette fonction, accessible via un pointeur dans la structure VIDEO_PORT_INT10_INTERFACE.
Exigences
Exigence | Valeur |
---|---|
client minimum pris en charge | Disponible dans Windows 2000 et versions ultérieures des systèmes d’exploitation Windows. |
plateforme cible | Bureau |
d’en-tête | video.h (include Video.h) |
IRQL | PASSIVE_LEVEL |