VideoPortLockPages, fonction (video.h)

Article
02/07/2025

La fonction VideoPortLockPages est obsolète dans Windows 2000 et versions ultérieures. Utilisez VideoPortLockBuffer à la place de cette fonction.

VideoPortLockPages verrouille la mémoire virtuelle spécifiée et effectue éventuellement une partie ou l’ensemble d’un transfert DMA.

Syntaxe

VIDEOPORT_DEPRECATED VIDEOPORT_API BOOLEAN VideoPortLockPages(
  [in]      IN PVOID                     HwDeviceExtension,
  [in, out] IN OUT PVIDEO_REQUEST_PACKET pVrp,
  [in]      IN PEVENT                    pUEvent,
  [in]      IN PEVENT                    pDisplayEvent,
  [in]      IN DMA_FLAGS                 DmaFlags
);

Paramètres

[in] HwDeviceExtension

Pointeur vers l’extension de périphérique du pilote miniport.

[in, out] pVrp

Pointeur vers une structure VIDEO_REQUEST_PACKET. Le pilote miniport doit avoir défini InputBuffer et InputBufferLength pour contenir l’adresse virtuelle et la taille en octets, respectivement, de la mémoire à verrouiller pour le transfert. Cette mémoire a été allouée par le pilote d’affichage et transmise au pilote miniport par le biais d’un IOCTL. Le port vidéo retourne un pointeur vers et la taille en octets de la liste de nuages de points/collecte dans OutputBuffer et OutputBufferLength, respectivement.

[in] pUEvent

Pointeur vers un événement utilisateur mappé à définir par le pilote miniport, ou NULL. L’événement utilisateur a été mappé par le pilote d’affichage et transmis au pilote miniport par le biais d’un IOCTL.

[in] pDisplayEvent

Pointeur vers un événement à définir par le pilote miniport ou NULL. Cet événement a été créé et reçu du pilote d’affichage par le biais d’un IOCTL.

[in] DmaFlags

Spécifie l’action à effectuer. Ce paramètre doit être l’une des valeurs suivantes :

Valeur	Signification
VideoPortDmaInitOnly	VideoPortLockPages verrouille la mémoire demandée.
VideoPortKeepPagesLocked	VideoPortLockPages n’effectue aucune action.
VideoPortUnlockAfterDma	VideoPortLockPages n’effectue aucune action.

Valeur de retour

VideoPortLockPages retourne TRUE une fois l’action demandée. Elle retourne FALSE si le paramètre DmaFlags n’est pas égal à VideoPortDmaInitOnly.

Remarques

Consultez Bus-Master DMA dans video Miniport Drivers pour plus d’informations sur les transferts DMA basés sur des paquets et des mémoires tampons courantes.

VideoPortLockPages ne peut pas être appelé à partir d’un ISR ou DPC.

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

Voir aussi

VideoPortLockBuffer

Partager via