VideoPortLockPages-Funktion (video.h)

Artikel
02/07/2025

Die funktion VideoPortLockPages ist veraltete in Windows 2000 und höher. Verwenden Sie VideoPortLockBuffer- anstelle dieser Funktion.

VideoPortLockPages sperrt den angegebenen virtuellen Speicher und führt möglicherweise einen Teil oder alle DMA-Übertragungen durch.

Syntax

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
);

Parameter

[in] HwDeviceExtension

Zeigen Sie auf die Geräteerweiterung des Miniporttreibers.

[in, out] pVrp

Zeiger auf eine VIDEO_REQUEST_PACKET Struktur. Der Miniporttreiber muss InputBuffer- und InputBufferLength- festgelegt haben, um die virtuelle Adresse bzw. die Größe des Speichers in Bytes zu enthalten, der für die Übertragung gesperrt werden soll. Dieser Speicher wurde vom Anzeigetreiber zugewiesen und über eine IOCTL an den Miniporttreiber übergeben. Der Videoport gibt einen Zeiger und die Größe in Byte der Punkt-/Gatherliste in OutputBuffer- bzw. OutputBufferLength-zurück.

[in] pUEvent

Zeiger auf ein zugeordnetes Benutzerereignis, das vom Miniporttreiber festgelegt werden soll, oder NULL-. Das Benutzerereignis wurde vom Anzeigetreiber zugeordnet und an den Miniporttreiber über eine IOCTL übergeben.

[in] pDisplayEvent

Zeiger auf ein Ereignis, das vom Miniporttreiber festgelegt werden soll, oder NULL-. Dieses Ereignis wurde von dem Anzeigetreiber über eine IOCTL erstellt und empfangen.

[in] DmaFlags

Gibt die auszuführende Aktion an. Dieser Parameter muss einen der folgenden Werte aufweisen:

Wert	Bedeutung
VideoPortDmaInitOnly	VideoPortLockPages sperrt den angeforderten Speicher.
VideoPortKeepPagesLocked	VideoPortLockPages führt keine Aktion aus.
VideoPortUnlockAfterDma	VideoPortLockPages führt keine Aktion aus.

Rückgabewert

VideoPortLockPages gibt TRUE- nach erfolgreichem Abschluss der angeforderten Aktion zurück. Es gibt FALSE- zurück, wenn der DmaFlags Parameter nicht gleich VideoPortDmaInitOnlyist.

Bemerkungen

Informationen zu paketbasierten und allgemeinen DMA-Übertragungen finden Sie unter Bus-Master DMA in Video Miniport Drivers.

VideoPortLockPages kann nicht von einem ISR oder DPC aufgerufen werden.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Verfügbar in Windows 2000 und höheren Versionen von Windows-Betriebssystemen.
Zielplattform-	Desktop
Header-	video.h (video.h einschließen)
Library	Videoprt.lib
DLL-	Videoprt.sys

Siehe auch

VideoPortLockBuffer-

Freigeben über