D3DDDI_RESERVEGPUVIRTUALADDRESS構造体 (d3dukmdt.h)

ユーザー モード グラフィックス ドライバーは、D3DDDI_RESERVEGPUVIRTUALADDRESS を D3D ランタイムの pfnReserveGpuVirtualAddressCb コールバックに渡して、現在のプロセスの GPU 仮想アドレス空間内のアドレス範囲を予約します。

構文

typedef struct D3DDDI_RESERVEGPUVIRTUALADDRESS {
  union {
    D3DKMT_HANDLE hPagingQueue;
    D3DKMT_HANDLE hAdapter;
  };
  D3DKMT_ALIGN64 D3DGPU_VIRTUAL_ADDRESS BaseAddress;
  D3DKMT_ALIGN64 D3DGPU_VIRTUAL_ADDRESS MinimumAddress;
  D3DKMT_ALIGN64 D3DGPU_VIRTUAL_ADDRESS MaximumAddress;
  D3DKMT_ALIGN64 D3DGPU_SIZE_T          Size;
  union {
    D3DDDIGPUVIRTUALADDRESS_RESERVATION_TYPE ReservationType;
    UINT                                     Reserved0;
  };
  union {
    D3DKMT_ALIGN64 UINT64 DriverProtection;
    D3DKMT_ALIGN64 UINT64 Reserved1;
  };
  D3DKMT_ALIGN64 D3DGPU_VIRTUAL_ADDRESS VirtualAddress;
  union {
    D3DKMT_ALIGN64 UINT64 PagingFenceValue;
    D3DKMT_ALIGN64 UINT64 Reserved2;
  };
} D3DDDI_RESERVEGPUVIRTUALADDRESS;

メンバーズ

hPagingQueue

このメンバーは廃止されています。 使用しないでください。

hAdapter

[in]DirectX グラフィックス アダプター ハンドルまたはゼロ (0)。 UMD hAdapter 0 に設定されている場合、D3D ランタイムは、D3DKMTReserveGpuVirtualAddress カーネル インターフェイスを呼び出す前に、hAdapter をカーネルのD3DKMT_HANDLEに設定します。

BaseAddress

[入力/省略可能]GPU 仮想アドレス空間で予約するバイト数。 BaseAddress は、64 KB の境界に揃える必要があります。

BaseAddress が NULL 以外の場合、ビデオ メモリ マネージャーはこのアドレスを予約範囲のベース アドレスとして使用しようとします。 BaseAddress から BaseAddress+Size までの範囲が空きでない場合、呼び出しは失敗します。 BaseAddress が NULL 以外の場合、MinimumAddress と MaximumAddress は無視されます。

NULL が指定されている場合、ビデオ メモリ マネージャーは、指定された MinimumAddress 内の割り当てのベース アドレスを選択し、MaximumAddressします。

MinimumAddress

[入力/省略可能]予約範囲について考慮する最小 GPU 仮想アドレス。 MinimumAddress はバイト単位であり、64 KB 境界にアラインする必要があります。 BaseAddress が NULL 以外の場合は無視されます。

MaximumAddress

[入力/省略可能]予約範囲について考慮する最大 GPU 仮想アドレス。 ビデオ メモリ マネージャーは、BaseAddressサイズ= MaximumAddressすることを保証します。 MaximumAddress NULL に設定されている場合、ビデオ メモリ マネージャーは制限を適用しません。

MaximumAddress はバイト単位であり、64 KB の境界にアラインする必要があります。 BaseAddress が NULL 以外の場合は無視されます。

Size

[in]予約する範囲のサイズ (バイト単位)。 64 KB の倍数である必要があります。

ReservationType

このメンバーは廃止されています。 使用しないでください。

Reserved0

このメンバーは予約されており、0 に設定する必要があります。

DriverProtection

このメンバーは廃止されています。 使用しないでください。

Reserved1

このメンバーは予約されており、0 に設定する必要があります。

VirtualAddress

[out]予約済み仮想アドレス。

PagingFenceValue

このメンバーは廃止されています。 使用しないでください。

Reserved2

このメンバーは予約されており、0 に設定する必要があります。

必要条件

要件 価値
サポートされる最小クライアント Windows 10
サポートされる最小サーバー Windows Server 2016
ヘッダー d3dukmdt.h (D3dumddi.h、D3dkmddi.h を含む)

関連項目

pfnReserveGpuVirtualAddressCb