Expand Minimize

DXGKARG_OPENALLOCATION structure

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

Syntax


typedef struct _DXGKARG_OPENALLOCATION {
  UINT                     NumAllocations;
  DXGK_OPENALLOCATIONINFO  *pOpenAllocation;
  VOID                     *pPrivateDriverData;
  UINT                     PrivateDriverSize;
  DXGK_OPENALLOCATIONFLAGS Flags;
#if (DXGKDDI_INTERFACE_VERSION >= DXGKDDI_INTERFACE_VERSION_WIN8)
  UINT                     SubresourceIndex;
  SIZE_T                   SubresourceOffset;
  UINT                     Pitch;
#endif 
} DXGKARG_OPENALLOCATION;

Members

NumAllocations

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

pOpenAllocation

[in/out] An array of DXGK_OPENALLOCATIONINFO structures for the allocations to open.

pPrivateDriverData

[in] 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.

PrivateDriverSize

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

Flags

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

SubresourceIndex

[in] 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.

SubresourceOffset

[out] Supported beginning with Windows 8.

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

Pitch

[out] 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

Version

Available beginning with Windows Vista.

Header

D3dkmddi.h (include D3dkmddi.h)

See also

DXGK_OPENALLOCATIONFLAGS
DXGK_OPENALLOCATIONINFO
DXGKARG_CREATEALLOCATION
DxgkDdiCreateAllocation
DxgkDdiOpenAllocation

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft