PINT10_ALLOCATE_BUFFER fonction de rappel (video.h)

Article
02/26/2024

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 un pilote de port vidéo pour l’interface. Cette valeur doit être identique à la valeur dans le membre Context de la structure VIDEO_PORT_INT10_INTERFACE après le retour de VideoPortQueryServices .

[out] Seg

Pointeur vers un emplacement de mémoire qui recevra l’adresse de 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 atteindre 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 retournée

La fonction Int10AllocateBuffer retourne NO_ERROR en cas de réussite. Il 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 à 4 096 octets est demandée.

Remarques

Le port vidéo implémente cette fonction, qui est accessible via un pointeur dans la structure VIDEO_PORT_INT10_INTERFACE .

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Disponible dans Windows 2000 et versions ultérieures des systèmes d’exploitation Windows.
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	video.h (inclure Video.h)
IRQL	PASSIVE_LEVEL

Voir aussi

VIDEO_PORT_INT10_INTERFACE

Partager via