PFND3DDDI_ALLOCATECB コールバック関数 (d3dumddi.h)

[アーティクル]
02/06/2025

pfnAllocateCb 関数は、システムまたはビデオメモリを割り当てます。

構文

PFND3DDDI_ALLOCATECB Pfnd3dddiAllocatecb;

HRESULT Pfnd3dddiAllocatecb(
  [in] HANDLE hDevice,
       D3DDDICB_ALLOCATE *unnamedParam2
)
{...}

パラメーター

[in] hDevice

ディスプレイデバイスへのハンドル (グラフィックスコンテキスト)。

unnamedParam2

pData [in, out]

割り当てを記述する D3DDDICB_ALLOCATE 構造体へのポインター。

戻り値

pfnAllocateCb は、次のいずれかの値を返します。

リターンコード	説明
S_OK	メモリが正常に割り当てられました。
E_INVALIDARG	パラメーターが検証され、正しくないと判断されました。
E_OUTOFMEMORY	pfnAllocateCb は、完了するために必要なメモリを割り当てませんでした。
D3DERR_OUTOFVIDEOMEMORY	ビデオメモリが不足しているため、pfnAllocateCb を完了できませんでした。ビデオメモリマネージャーは、ビデオメモリの仮想化を試みます。ただし、仮想化が失敗した場合 (仮想アドレス空間が不足した場合など)、メモリマネージャーはこのエラーコードを返す可能性があります。
D3DDDIERR_DEVICEREMOVED	pfnAllocateCb は、プラグアンドプレイ (PnP) の停止またはタイムアウト検出と回復 (TDR) イベントが発生したため、ディスプレイミニポートドライバーの DxgkDdiCreateAllocation 関数への呼び出しを開始できませんでした。 pfnAllocateCb (通常、CreateResource、CreateResource(D3D10)、CreateResource(D3D11) 関数) を呼び出したユーザーモード表示ドライバー関数は、このエラーコードを Direct3D ランタイムに返す必要があります。 Direct3D バージョン 9 注: エラーコードの返しの詳細については、「ランタイム関数から受信したエラーコードを返すを参照してください。 Direct3D バージョン 10 および 11 注: ドライバー関数が値を返さない場合 (つまり、戻り値のパラメーター型に VOID がある場合)、ドライバー関数は pfnSetErrorCb 関数を呼び出して、エラーコードをランタイムに返します。エラーコードの処理の詳細については、「エラーの処理」を参照してください。

この関数は、他の HRESULT 値を返す場合もあります。

備考

ユーザーモードのディスプレイドライバーは、pfnAllocateCb を呼び出して、システムまたはビデオメモリ (割り当てとも呼ばれます) を割り当てます。次に、Microsoft DirectX グラフィックスカーネルサブシステム (Dxgkrnl.sys) は、ディスプレイミニポートドライバーの DxgkDdiCreateAllocation 関数を呼び出して、pfnAllocateCb 要求で渡されたプライベートデータを解釈して格納します。ディスプレイミニポートドライバーは、ビデオメモリマネージャー (Dxgkrnl.sysの一部) が実際にメモリを割り当てるために使用する DxgkDdiCreateAllocation 呼び出しから情報を返します。

通常、ユーザーモードのディスプレイドライバーは、CreateResource、CreateResource(D3D10)、または CreateResource(D3D11) 関数の呼び出しに応答して割り当てを作成します。ただし、ユーザーモードディスプレイドライバーは、ユーザーモードディスプレイドライバーの CreateDevice、または CreateDevice(D3D10) 関数がビデオメモリにスクラッチパッド領域を作成する場合など、いつでも割り当てを作成できます。

ユーザーモードディスプレイドライバーは、次の種類の割り当てを作成できます。

Microsoft Direct3D ランタイムがシステムメモリを事前に割り当てるシステムメモリ割り当て。この状況では、ユーザーモードのディスプレイドライバーは、配置またはその他のパラメーターを設定できません。ユーザーモードディスプレイドライバーは、ハードウェアからアクセスできる事前に割り当てられたシステムメモリが必要な場合は、pfnAllocateCb 呼び出します。 Direct3D ランタイムは、pData が指す D3DDDICB_ALLOCATE 構造体の pAllocationInfo メンバーの D3DDDI_ALLOCATIONINFO 構造体の pSystemMem メンバー内のシステムメモリポインター返します。ユーザーモードディスプレイドライバーが、ハードウェアからアクセスできる事前に割り当てられたシステムメモリを必要としない場合は、この種類のメモリ pfnAllocateCb を呼び出さないでください。
ユーザーモードディスプレイドライバーが作成に参加できるシステムとビデオのメモリ割り当て。

ドライバーが複数の割り当てを作成しようとすると、ドライバーはすべての割り当てを親リソースに関連付けることができます (たとえば、各バックバッファーが個々の割り当てである反転チェーンを作成するとき)。ドライバーは、pData が指す D3DDDICB_ALLOCATE 構造体の hResource メンバーを、ドライバーの CreateResource、CreateResource(D3D10)、または CreateResource(D3D11) 関数渡された値に設定することで、このような関連付けを実行できます。これに対して、Direct3D ランタイムは、hKMResource D3DDDICB_ALLOCATE メンバーのカーネルモードリソースハンドル (D3DKMT_HANDLE データ型) を返します。ユーザーモードディスプレイドライバーは、その後、ディスプレイミニポートドライバーで使用するコマンドストリームにこのカーネルモードリソースハンドルを挿入できます。

ディスプレイミニポートドライバーは、このカーネルモードのリソースハンドル (通常は、その DxgkDdiRender 関数内) で DxgkCbGetHandleData 関数を呼び出して、リソースに関連付けられているプライベートデータを取得できます。また、ディスプレイミニポートドライバーは、DxgkCbEnumHandleChildren 関数を呼び出して、リソースに関連付けられているすべての割り当てを取得できます。ディスプレイミニポートドライバーは、DxgkCbGetHandleParent 関数を呼び出して、子割り当てハンドルから親カーネルモードリソースハンドルを取得することもできます。

ユーザーモードディスプレイドライバーが pfnAllocateCb を呼び出すときに、D3DDDICB_ALLOCATEの hResource メンバーが NULL設定されている場合、割り当てはリソースではなくデバイスに関連付けられます。ドライバーは、違いがセマンティックであることを判断できます。リソースへの割り当ての関連付けは省略可能ですが、デバッグと診断の目的で推奨されます。

Direct3D バージョン 9 注: リソースの作成と破棄の詳細については、「リソースの作成と破棄のの処理」を参照してください。

Direct3D バージョン 11 注: ドライバーが pfnAllocateCb 呼び出す方法の詳細については、Direct3D 10 からの変更を参照してください。

次のコード例は、リソースにメモリを割り当てる方法を示しています。

    D3DDDICB_ALLOCATE           allocCB;
    D3DDDI_ALLOCATIONINFO       allocInfo;
    HRESULT                     hr;
    memset(&allocInfo,   0, sizeof(allocInfo));
    memset(&allocCB,     0, sizeof(allocCB));
    // Set the VidPN source ID for the primary and fullscreen back buffer
    if (m_dwCurResCaps.Primary) {
        allocInfo.Flags.Primary = TRUE;
        allocInfo.VidPnSourceId = m_VidPnSourceId;
    }
    // Check if the allocation is in system memory
    if (pSysMem) {
        allocInfo.pSystemMem = pSysMem;
    }
    // Use the runtime handle of the resource being created
    // NOTE: This is critical for supporting a shared resource
    allocCB.hResource = m_hCurResRuntime;

    allocCB.NumAllocations = 1;
    allocCB.pAllocationInfo = &allocInfo;

    hr = m_d3dCallbacks.pfnAllocateCb(m_hD3D, &allocCB);

    if (FAILED(hr)) {
        allocInfo.hAllocation = NULL;
    }
    else {
        *phAllocation = allocInfo.hAllocation;
    }

    return (hr);

必要条件

要件	価値
サポートされる最小クライアント	Windows Vista 以降のバージョンの Windows オペレーティングシステムで使用できます。
ターゲットプラットフォームの	デスクトップ
ヘッダー	d3dumddi.h (D3dumddi.h を含む)

次の方法で共有

PFND3DDDI_ALLOCATECB コールバック関数 (d3dumddi.h)

構文

パラメーター

戻り値

備考

必要条件

関連項目

フィードバック

その他のリソース