DXGKDDI_OPENALLOCATIONINFOコールバック関数 (d3dkmddi.h)
DxgkDdiOpenAllocation 関数は、DxgkDdiCreateAllocation 関数が作成した非デバイス固有の割り当てを、指定されたグラフィックス コンテキスト デバイスに固有の割り当てにバインドします。
構文
DXGKDDI_OPENALLOCATIONINFO DxgkddiOpenallocationinfo;
NTSTATUS DxgkddiOpenallocationinfo(
[in] IN_CONST_HANDLE hDevice,
[in] IN_CONST_PDXGKARG_OPENALLOCATION pOpenAllocation
)
{...}
パラメーター
[in] hDevice
割り当てがバインドされるグラフィックス コンテキスト デバイスへのハンドル。 ディスプレイ ミニポート ドライバーの DxgkDdiCreateDevice 関数は、DXGKARG_CREATEDEVICE 構造体の hDevice メンバー内の Microsoft DirectX グラフィックス カーネル サブシステムにこのハンドルを以前に提供しました。
[in] pOpenAllocation
バインド割り当てに関する情報を含む DXGKARG_OPENALLOCATION 構造体へのポインター。
戻り値
DxgkDdiOpenAllocation は、次のいずれかの値を返します。
| リターン コード | 形容 |
|---|---|
| STATUS_SUCCESS | DxgkDdiOpenAllocation は、hDevice パラメーターが指定したグラフィックス コンテキスト デバイスに割り当てを正常にバインドしました。 |
| STATUS_INVALID_PARAMETER | DxgkDdiOpenAllocation に渡されたパラメーターには、完了を妨げるエラーが含まれていました。 |
| STATUS_NO_MEMORY | DxgkDdiOpenAllocation は、完了するために必要なメモリを割り当てませんでした。 |
| STATUS_GRAPHICS_DRIVER_MISMATCH | ディスプレイ ミニポート ドライバーは、DxgkDdiOpenAllocation への呼び出しを開始したユーザー モードのディスプレイ ドライバー (つまり、ディスプレイ ミニポート ドライバーにプライベート データを提供) と互換性がありません。 |
備考
DirectX グラフィックス カーネル サブシステムは、ディスプレイ ミニポート ドライバーの DxgkDdiOpenAllocation 関数を呼び出して、DxgkDdiCreateAllocation 関数が作成した非デバイス固有の割り当てを、hDevice パラメーターが指定するグラフィックス コンテキスト デバイスに固有の割り当てにバインドします。 ディスプレイ ミニポート ドライバーは、ドライバーがデバイスに固有の割り当てデータを追跡できるように、デバイスに割り当てをバインドします。
ディスプレイ ミニポート ドライバーは、任意のプロセス (同じグラフィックス アダプター上) を作成し、作成プロセス内のデバイスだけでなく、任意のデバイスに割り当てをバインドできます。
DxgkDdiOpenAllocation STATUS_SUCCESSが返されると、ドライバーは、各割り当ての DXGK_OPENALLOCATIONINFO 構造体の hDeviceSpecificAllocation メンバーを NULL 以外の値に設定します。 各割り当てのDXGK_OPENALLOCATIONINFO構造体は、DXGKARG_OPENALLOCATION 構造体の pOpenAllocation メンバーが指定する配列の要素です。
ドライバーは、割り当てが作成された場合にのみ、DXGK_OPENALLOCATIONINFO 構造体の pPrivateDriverData メンバーに渡される割り当てプライベート ドライバー データを変更できます (これは、DXGKARG_OPENALLOCATION 構造体の Flags メンバーの 作成 ビット フィールド フラグが設定されている場合に示されます)。 ドライバーは、割り当てが開かれたときにのみ割り当てプライベート ドライバー データを読み取ることができると判断する必要があります (つまり、作成 ビット フィールド フラグが設定されていない場合)。
DxgkDdiOpenAllocation ページング可能にする必要があります。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | Windows Vista |
| ターゲット プラットフォーム の | デスクトップ |
| ヘッダー | d3dkmddi.h |
| IRQL | PASSIVE_LEVEL |
関連項目
DxgkDdiCreateAllocation の
DxgkDdiCreateDevice の