VideoPortAllocateBuffer, fonction (video.h)
La fonction VideoPortAllocateBuffer est obsolète dans Windows 2000 et versions ultérieures. À sa place, les pilotes de miniport vidéo doivent utiliser VideoPortAllocatePool.
VideoPortAllocateBuffer alloue une mémoire tampon de mémoire de pool paginée.
Syntaxe
VIDEOPORT_DEPRECATED VIDEOPORT_API VP_STATUS VideoPortAllocateBuffer(
[in] IN PVOID HwDeviceExtension,
[in] IN ULONG Size,
[out] OUT PVOID *Buffer
);
Paramètres
[in] HwDeviceExtension
Pointeur vers l’extension de périphérique du pilote miniport.
[in] Size
Spécifie la taille de la mémoire tampon à allouer, en octets.
[out] Buffer
Emplacement dans lequel le pilote de port vidéo retourne un pointeur vers un pointeur vers la mémoire du pool allouée.
Valeur de retour
VideoPortAllocateBuffer retourne NO_ERROR lorsqu’il termine correctement la demande d’allocation, ou ERROR_NOT_ENOUGH_MEMORY s’il n’est pas en mesure d’allouer une mémoire tampon de Taille octets. Une valeur de retour de ERROR_INSUFFICIENT_BUFFER indique qu’un pilote miniport a dépassé son allocation maximale autorisée de mémoire.
Remarques
Un pilote miniport peut utiliser la valeur de retour de cette fonction pour déterminer si l’allocation de mémoire tampon a réussi.
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) |
| bibliothèque | Videoprt.lib |
| DLL | Videoprt.sys |
| IRQL | PASSIVE_LEVEL |