DXGKCB_AGP_ALLOCATE_POOL コールバック関数 (dispmprt.h)
DXGKCB_AGP_ALLOCATE_POOLコールバック関数は、高速グラフィックス ポート (AGP) メモリを予約、コミット、マップします。
構文
DXGKCB_AGP_ALLOCATE_POOL DxgkcbAgpAllocatePool;
NTSTATUS DxgkcbAgpAllocatePool(
[in] IN HANDLE Context,
[in] IN ULONG AllocationSize,
[in] IN MEMORY_CACHING_TYPE CacheType,
[out] OUT PPHYSICAL_ADDRESS PhysicalAddress,
[out] OUT PVOID *VirtualAddress
)
{...}
パラメーター
[in] Context
AGP インターフェイスに関連付けられているコンテキスト ブロックへのハンドル。 ディスプレイ ミニポート ドライバーは、DxgkCbQueryServices によって入力されたDXGK_AGP_INTERFACE構造体の Context メンバーで、このハンドルを以前に受け取っていました。
[in] AllocationSize
割り当てられる AGP メモリのサイズ (バイト単位)。
[in] CacheType
割り当てられた AGP メモリにアクセスするときに CPU がキャッシュまたは書き込みの組み合わせを使用できるかどうかを指定する、 MEMORY_CACHING_TYPE 列挙からの定数。
[out] PhysicalAddress
AGP 割り当ての基本物理アドレスを受け取るPHYSICAL_ADDRESS構造体へのポインター。 これは、GPU が AGP メモリへのアクセスに使用する物理アドレス範囲のベースです。
[out] VirtualAddress
AGP 割り当ての基本仮想アドレス (システム空間) を受け取る変数へのポインター。 これは、CPU が AGP メモリへのアクセスに使用する仮想アドレス範囲のベースです。
戻り値
成功した場合、AgpAllocatePool はSTATUS_SUCCESSを返します。 それ以外の場合は、 Ntstatus.h で定義されているエラー コードのいずれかを返します。
注釈
ディスプレイ ミニポート ドライバーの DxgkDdiStartDevice 関数で AgpAllocatePool を呼び出します。 DxgkDdiStartDevice の実行後に呼び出すと、AgpAllocatePool が失敗する可能性があります。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista |
| 対象プラットフォーム | デスクトップ |
| Header | dispmprt.h (Dispmprt.h を含む) |
| IRQL | PASSIVE_LEVEL |