PFND3DKMT_CREATEALLOCATION コールバック関数 (d3dkmthk.h)

D3DKMTCreateAllocation 関数は、システムまたはビデオ メモリの割り当てを作成します。

構文

PFND3DKMT_CREATEALLOCATION Pfnd3dkmtCreateallocation;

NTSTATUS Pfnd3dkmtCreateallocation(
  D3DKMT_CREATEALLOCATION *unnamedParam1
)
{...}

パラメーター

unnamedParam1

pData [in, out]

割り当てを作成するための情報を含む D3DKMT_CREATEALLOCATION 構造体へのポインター。

戻り値

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

リターン コード	説明
STATUS_SUCCESS	割り当てが正常に作成されました。
STATUS_DEVICE_REMOVED	グラフィックス アダプターが停止したか、ディスプレイ デバイスがリセットされました。
STATUS_INVALID_PARAMETER	パラメーターが検証され、正しくないと判断されました。
STATUS_NO_MEMORY	メモリ不足のため、D3DKMTCreateAllocation を完了できませんでした。
STATUS_NO_VIDEO_MEMORY	ビデオ メモリが不足しているため、D3DKMTCreateAllocation を完了できませんでした。 ビデオ メモリ マネージャーは、ビデオ メモリの仮想化を試みます。ただし、仮想化が失敗した場合 (仮想アドレス空間が不足した場合など)、メモリ マネージャーはこのエラー コードを返す可能性があります。

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

注釈

OpenGL ICD は 、D3DKMTCreateAllocation 関数を使用して割り当てとリソースを作成します。 割り当てはリソースに関連付けるか、割り当てをスタンドアロンにすることができます。 D3DKMTCreateAllocation 関数を使用して、いつでもリソースに割り当てを追加することもできます。 唯一の制限は、すべての共有割り当てをリソースに関連付ける必要があり、追加の割り当てを既存の共有リソースに追加できないことです。

例

次のコード例では、OpenGL ICD で D3DKMTCreateAllocation を使用して、リソースに関連付けられていないスタンドアロン割り当てをビデオ メモリに作成する方法を示します。

D3DKMT_HANDLE CreateStandAloneAllocation(D3DKMT_HANDLE hDevice, VOID* pPrivateAllocationInfo, UINT Size)
{
    D3DKMT_CREATEALLOCATION CreateAllocation;
    D3DDDI_ALLOCATIONINFO AllocationInfo;

    memset(&CreateAllocation, 0, sizeof(CreateAllocation));
    CreateAllocation.hDevice = hDevice;
    CreateAllocation.NumAllocations = 1;
    CreateAllocation.pAllocationInfo = &AllocationInfo;

    AllocationInfo.hAllocation = NULL;
    AllocationInfo.pSystemMem = NULL;  // Vidmem allocation
    AllocationInfo.pPrivateDriverData = pPrivateAllocationInfo;  // Contains format, size, and so on.
    AllocationInfo.PrivateDriverDataSize = Size;

    if (NT_SUCCESS((*pfnKTCreateAllocation)(&CreateAllocation))) {
        return AllocationInfo.hAllocation;
    }
    return 0;
}

次のコード例では、OpenGL ICD で D3DKMTCreateAllocation を使用して、1 つのシステム メモリ割り当てでリソースを作成する方法を示します。

HRESULT CreateSysmemResource(D3DKMT_HANDLE hDevice, 
                             UINT AllocationSize, 
                             VOID* pResourceData, 
                             UINT ResourceDataSize,
                             VOID* pAllocationData, 
                             UINT AllocationDataSize,
                             D3DKMT_HANDLE* phResource,
                             D3DKMT_HANDLE* phAllocation)
{
    D3DKMT_CREATEALLOCATION CreateAllocation;
    D3DDDI_ALLOCATIONINFO AllocationInfo;
    VOID* pSysMem;

    *phResource = NULL;
    *phAllocation = NULL;

    // For a sysmem allocation, preallocate the memory.
    pSysMem = MemAlloc(AllocationSize);
    if (pSysMem == NULL) {
        return E_OUTOFMEMORY;
    }
 
    memset(&CreateAllocation, 0, sizeof(CreateAllocation));
    CreateAllocation.hDevice = hDevice;
    CreateAllocation.Flags.CreateResource = TRUE;
    CreateAllocation.pPrivateDriverData = pResourceData;
    CreateAllocation.PrivateDriverDataSize = ResourceDataSize;
    CreateAllocation.NumAllocations = 1;
    CreateAllocation.pAllocationInfo = &AllocationInfo;

    AllocationInfo.hAllocation = NULL;
    AllocationInfo.pSystemMem = pSysMem;
    AllocationInfo.pPrivateDriverData = pAllocationData;
    AllocationInfo.PrivateDriverDataSize = AllocationDataSize;

    if (NT_SUCCESS((*pfnKTCreateAllocation)(&CreateAllocation))) {
        *phResource = CreateAllocation.hResource;
        *phAllocation = AllocationInfo.hAllocation;
        return S_OK;
    }
    MemFree(pSysMem);
    return E_FAIL;
}

要件

要件	値
サポートされている最小のクライアント	Windows Vista
対象プラットフォーム	ユニバーサル
Header	d3dkmthk.h (D3dkmthk.h を含む)

こちらもご覧ください

D3DKMT_CREATEALLOCATION