videoPortLockPages 函式 (video.h)
VideoPortLockPages 函式在 Windows 2000 和更新版本中已過時。 使用 VideoPortLockBuffer 取代此函式。
VideoPortLockPages 會鎖定指定的虛擬記憶體，而且可能會執行部分或所有 DMA 傳輸。
語法
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
);
參數
[in] HwDeviceExtension
迷你埠驅動程式裝置延伸模組的指標。
[in, out] pVrp
VIDEO_REQUEST_PACKET 結構的指標。 迷你埠驅動程序必須設定 InputBuffer 和 InputBufferLength，以分別包含要鎖定傳輸之內存的虛擬位址和位元組大小。 此記憶體是由顯示驅動程式所配置，並透過IOCTL傳遞至迷你埠驅動程式。 視訊埠會分別傳回指標，以及 OutputBuffer 和 OutputBufferLength 中散佈/收集清單位元組的大小。
[in] pUEvent
要由迷你埠驅動程式或 NULL 設定之對應使用者事件的指標。 使用者事件是由顯示驅動程式所對應，並透過IOCTL傳遞至迷你埠驅動程式。
[in] pDisplayEvent
要由迷你埠驅動程式或 NULL 設定的事件指標。 此事件是由 透過IOCTL從顯示驅動程式建立並接收。
[in] DmaFlags
指定要執行的動作。 此參數必須是下列其中一個值：
| 值 | 意義 |
|---|---|
| VideoPortDmaInitOnly | VideoPortLockPages 會鎖定要求的記憶體。 |
| VideoPortKeepPagesLocked | VideoPortLockPages 不會採取任何動作。 |
| VideoPortUnlockAfterDma | VideoPortLockPages 不會採取任何動作。 |
傳回值
VideoPortLockPages 會在成功完成所要求的動作時傳回 TRUE 。 如果 DmaFlags 參數不等於 VideoPortDmaInitOnly，則會傳回 FALSE。
備註
如需封包型和通用緩衝區 DMA 傳輸的相關信息，請參閱 Video Miniport Drivers 中的 Bus-Master DMA。
無法從 ISR 或 DPC 呼叫 VideoPortLockPages。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | 適用於 Windows 2000 和更新版本的 Windows 作業系統。 |
| 目標平台 | 桌面 |
| 標頭 | video.h (包含 Video.h) |
| 程式庫 | Videoprt.lib |
| Dll | Videoprt.sys |