PDD_MAPMEMORY コールバック関数 (ddrawint.h)

[アーティクル]
08/23/2023

DdMapMemory コールバック関数は、フレームバッファーのアプリケーション変更可能な部分を、指定されたプロセスのユーザーモードアドレス空間にマップするか、メモリのマップを解除します。

構文

PDD_MAPMEMORY PddMapmemory;

DWORD PddMapmemory(
  PDD_MAPMEMORYDATA unnamedParam1
)
{...}

パラメーター

unnamedParam1

メモリマッピングまたはマッピング解除操作の詳細を含む DD_MAPMEMORYDATA 構造体を指します。

戻り値

DdMapMemory は、次のいずれかのコールバックコードを返します。

注釈

DdMapMemory は、 DdLock の最初の呼び出しの前にメモリマッピングを実行するために呼び出されます。 lpMapMemory のDD_MAPMEMORYDATA構造体の fpProcess メンバーでドライバーによって返されるハンドルは、ドライバーで行われるすべての DdLock 呼び出しに渡されます。

DdMapMemory は、最後の DdUnlock 呼び出しが行われた後にメモリのマップを解除するためにも呼び出されます。

ドライバーのクラッシュを防ぐために、ドライバーは、アプリケーションで変更してはならないフレームバッファーの一部をマップすることはできません。

ディスプレイドライバーは、メモリマッピングまたはマップ解除を実行するビデオミニポートドライバーを呼び出す必要があります。メモリをマップするビデオミニポートドライバーに同期要求を送信するには、ディスプレイドライバーは、IOCTL_VIDEO_SHARE_VIDEO_MEMORYまたはIOCTL_VIDEO_MAP_VIDEO_MEMORYを使用して EngDeviceIoControl GDI 関数を呼び出します。ディスプレイドライバーは、メモリのマップを解除するために、ビデオミニポートドライバーに IOCTL_VIDEO_UNSHARE_VIDEO_MEMORYまたはIOCTL_VIDEO_UNMAP_VIDEO_MEMORY を送信します。詳細については、「ビデオミニポートドライバーへの IOCTL の通信」を参照してください。

DdMapMemory は、無効な PDEV を使用してのみ呼び出してメモリのマップを解除できます。 PDEV は、ディスプレイドライバーの DrvAssertMode 関数を呼び出すことによって無効または有効になります。詳細については、「 PDEV の管理」を参照してください。