Edit

DXGKARG_CREATEALLOCATION structure (d3dkmddi.h)

  • Article

The DXGKARG_CREATEALLOCATION structure describes how the display miniport driver should create allocations.

Syntax

typedef struct _DXGKARG_CREATEALLOCATION {
  [in]     const VOID                 *pPrivateDriverData;
  [in]     UINT                       PrivateDriverDataSize;
  [in]     UINT                       NumAllocations;
  [in/out] DXGK_ALLOCATIONINFO        *pAllocationInfo;
  [in/out] HANDLE                     hResource;
  [in]     DXGK_CREATEALLOCATIONFLAGS Flags;
} DXGKARG_CREATEALLOCATION;

Members

[in] pPrivateDriverData

A pointer to a block of private data that is passed from the user-mode display driver to the display miniport driver. This member is typically used to provide data for a group of allocations. Note that this member is distinct from the pPrivateDriverData members of the DXGK_ALLOCATIONINFO structures in the array that pAllocationInfo specifies. You can set private data for this member in addition to private data for each allocation.

[in] PrivateDriverDataSize

The size, in bytes, of the private data that pPrivateDriverData points to.

[in] NumAllocations

The number of elements in the array that pAllocationInfo specifies, which represents the number of allocations to create.

[in/out] pAllocationInfo

An array of DXGK_ALLOCATIONINFO structures that describe the allocations to create.

[in/out] hResource

A handle to a resource. The display miniport driver can set this handle to a value that the Microsoft DirectX graphics kernel subsystem can subsequently pass in driver calls and that refers to information for the allocations. If the resource was already created by a previous DxgkDdiCreateAllocation call, this member contains the handle that the driver previously returned.

[in] Flags

A DXGK_CREATEALLOCATIONFLAGS structure that identifies how to create allocations. Setting all of the bit-field flags to 0 indicates that allocations belong to the device and not to a particular resource.

Requirements

Requirement Value
Minimum supported client Windows Vista
Header d3dkmddi.h (include D3dkmddi.h)

See also

DXGK_ALLOCATIONINFO

DXGK_CREATEALLOCATIONFLAGS

DxgkDdiCreateAllocation