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 傳輸的相關信息，請參閱影片迷你埠驅動程式中的 Bus-Master DMA。
VideoPortLockPages 無法從 ISR 或 DPC 呼叫。
要求
| 要求 | 價值 |
|---|---|
| 最低支援的用戶端 | 適用於 Windows 2000 和更新版本的 Windows作系統。 |
| 目標平臺 | 桌面 |
| 標頭 | video.h （include Video.h） |
| 連結庫 | Videoprt.lib |
| DLL | Videoprt.sys |