Edit

DXGKARG_OPENALLOCATION structure (d3dkmddi.h)

  • Article

The DXGKARG_OPENALLOCATION structure describes allocations that the display miniport driver should open.

Syntax

typedef struct _DXGKARG_OPENALLOCATION {
  [in]     UINT                     NumAllocations;
  [in/out] DXGK_OPENALLOCATIONINFO  *pOpenAllocation;
  [in]     VOID                     *pPrivateDriverData;
  [in]     UINT                     PrivateDriverSize;
  [in]     DXGK_OPENALLOCATIONFLAGS Flags;
  [in]     UINT                     SubresourceIndex;
  [out]    SIZE_T                   SubresourceOffset;
  [out]    UINT                     Pitch;
} DXGKARG_OPENALLOCATION;

Members

[in] NumAllocations

The number of elements in the array that the pOpenAllocation member specifies, which represents the number of device-specific allocations to open.

[in/out] pOpenAllocation

An array of DXGK_OPENALLOCATIONINFO structures for the allocations to open.

[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 block of private data is the same resource-specific data that is passed in the pPrivateDriverData member of the DXGKARG_CREATEALLOCATION structure in the call to the DxgkDdiCreateAllocation function. The display miniport driver cannot modify this block of private data.

[in] PrivateDriverSize

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

[in] Flags

A DXGK_OPENALLOCATIONFLAGS structure that identifies the operation to perform for allocations.

[in] SubresourceIndex

Supported beginning with Windows 8.

An index into the resource for the render target surface.

The operating system specifies this member only if the display miniport driver supports GDI Hardware Acceleration. Specifically, the display miniport driver must implement the DxgkDdiRenderKm function and must create the device with the GdiDevice member set in DXGKARG_CREATEDEVICE.Flags.

If the value of SubresourceIndex is greater than the number of subresources in the allocation, the display miniport driver should return an error.

[out] SubresourceOffset

Supported beginning with Windows 8.

The offset, in bytes, from the start of the allocation to the start of the subresource.

[out] Pitch

Supported beginning with Windows 8.

The pitch, in bytes, of the allocation—that is, the distance, in bytes, to the start of the next row.

Requirements

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

See also

DXGKARG_CREATEALLOCATION

DXGK_OPENALLOCATIONFLAGS

DXGK_OPENALLOCATIONINFO

DxgkDdiCreateAllocation

DxgkDdiOpenAllocation