VideoPortLockPages-Funktion (video.h)

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

VideoPortLockPages sperrt den angegebenen virtuellen Arbeitsspeicher und führt möglicherweise einen Teil oder die gesamte DMA-Übertragung aus.

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

Zeiger auf die Geräteerweiterung des Miniporttreibers.

[in, out] pVrp

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

[in] pUEvent

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

[in] pDisplayEvent

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

[in] DmaFlags

Gibt die auszuführende Aktion an. Dieser Parameter muss einer der folgenden Werte sein:

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

Rückgabewert

VideoPortLockPages gibt TRUE zurück, wenn die angeforderte Aktion erfolgreich abgeschlossen wurde. Es gibt FALSE zurück, wenn der DmaFlags-Parameter nicht gleich VideoPortDmaInitOnly ist.

Hinweise

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

VideoPortLockPages kann nicht von einem ISR oder DPC aufgerufen werden.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar in Windows 2000 und höheren Versionen der Windows-Betriebssysteme.
Zielplattform	Desktop
Kopfzeile	video.h (einschließen von Video.h)
Bibliothek	Videoprt.lib
DLL	Videoprt.sys

Weitere Informationen

VideoPortLockBuffer