PDD_MAPMEMORY回呼函式 (ddrawint.h)

DdMapMemory 回呼函式會將框架緩衝區的應用程式可修改部分對應至指定進程的使用者模式位址空間，或取消對應記憶體。

語法

PDD_MAPMEMORY PddMapmemory;

DWORD PddMapmemory(
  PDD_MAPMEMORYDATA unnamedParam1
)
{...}

unnamedParam1

指向包含記憶體對應或取消對應作業詳細數據的 DD_MAPMEMORYDATA 結構。

DdMapMemory 會傳回下列其中一個回呼代碼：

第一次呼叫 DdLock 之前，會呼叫 DdMapMemory 來執行記憶體對應。驅動程式在 lpMapMemory 之 DD_MAPMEMORYDATA 結構的 fpProcess 成員中傳回的句柄，將會傳遞至驅動程式上所做的每個 DdLock 呼叫。

在進行最後一次 DdUnlock 呼叫之後，也會呼叫 DdMapMemory 來取消對應記憶體。

若要防止驅動程式當機，驅動程式不得對應應用程式不得修改之畫面緩衝區的任何部分。

顯示驅動程式必須在視訊迷你埠驅動程式上呼叫，才能執行記憶體對應或取消對應。若要將同步要求傳送至視訊迷你埠驅動程式以對應記憶體，顯示驅動程式會使用 IOCTL_VIDEO_SHARE_VIDEO_MEMORY 或 IOCTL_VIDEO_MAP_VIDEO_MEMORY 呼叫 EngDeviceIoControl GDI 函式。顯示驅動程式會將 IOCTL_VIDEO_UNSHARE_VIDEO_MEMORY 或 IOCTL_VIDEO_UNMAP_VIDEO_MEMORY 傳送至視訊迷你埠驅動程式，以取消對應記憶體。如需詳細資訊，請參閱將IOCTL與Video Miniport驅動程序通訊。

DdMapMemory 只能使用停用的 PDEV 呼叫，以取消對應記憶體。呼叫顯示器驅動程式的 DrvAssertMode 函式，以停用或啟用PDEV。如需詳細資訊，請參閱管理 PDEV 。