VideoPortLockPages, fonction (video.h)

  • Article

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 la totalité 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 passée 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 points/regroupements dans OutputBuffer et OutputBufferLength, respectivement.

[in] pUEvent

Pointeur vers un événement utilisateur mappé qui doit être défini 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 qui doit être défini par le pilote miniport, ou NULL. Cet événement a été créé par le pilote d’affichage et reçu par le biais d’un IOCTL.

[in] DmaFlags

Indique l'action à effectuer. Ce paramètre doit avoir 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 retournée

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

Remarques

Consultez Bus-Master DMA in Video Miniport Drivers pour plus d’informations sur les transferts DMA basés sur les paquets et les mémoires tampons communes.

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

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 (incluez Video.h)
Bibliothèque Videoprt.lib
DLL Videoprt.sys

Voir aussi

VideoPortLockBuffer