Expand Minimize

DXGKARG_GETSTANDARDALLOCATIONDRIVERDATA structure

The DXGKARG_GETSTANDARDALLOCATIONDRIVERDATA structure describes a standard allocation type.

Syntax


typedef struct _DXGKARG_GETSTANDARDALLOCATIONDRIVERDATA {
  D3DKMDT_STANDARDALLOCATION_TYPE StandardAllocationType;
  union {
    D3DKMDT_SHAREDPRIMARYSURFACEDATA *pCreateSharedPrimarySurfaceData;
    D3DKMDT_SHADOWSURFACEDATA        *pCreateShadowSurfaceData;
    D3DKMDT_STAGINGSURFACEDATA       *pCreateStagingSurfaceData;
#if (DXGKDDI_INTERFACE_VERSION >= DXGKDDI_INTERFACE_VERSION_WIN7)
    D3DKMDT_GDISURFACEDATA           *pCreateGdiSurfaceData;
#endif 
  };
  VOID                            *pAllocationPrivateDriverData;
  UINT                            AllocationPrivateDriverDataSize;
  VOID                            *pResourcePrivateDriverData;
  UINT                            ResourcePrivateDriverDataSize;
} DXGKARG_GETSTANDARDALLOCATIONDRIVERDATA;

Members

StandardAllocationType

[in] A D3DKMDT_STANDARDALLOCATION_TYPE-typed value that identifies the type of standard allocation to describe.

pCreateSharedPrimarySurfaceData

[in] A pointer to a D3DKMDT_SHAREDPRIMARYSURFACEDATA structure, if StandardAllocationType specifies D3DKMDT_STANDARDALLOCATION_SHAREDPRIMARYSURFACE.

pCreateShadowSurfaceData

[in] A pointer to a D3DKMDT_SHADOWSURFACEDATA structure, if StandardAllocationType specifies D3DKMDT_STANDARDALLOCATION_SHADOWSURFACE.

pCreateStagingSurfaceData

[in] A pointer to a D3DKMDT_STAGINGSURFACEDATA structure, if StandardAllocationType specifies D3DKMDT_STANDARDALLOCATION_STAGINGSURFACE.

pCreateGdiSurfaceData

[in] A pointer to a D3DKMDT_GDISURFACEDATA structure, only available if StandardAllocationType specifies D3DKMDT_STANDARDALLOCATION_GDISURFACE.

This member is available beginning with Windows 7.

pAllocationPrivateDriverData

[in/out] A pointer to a block of allocation private data that describes the standard allocation type; otherwise, this member is NULL. The allocation private data that the display miniport driver's DxgkDdiGetStandardAllocationDriverData function returns depends on the type that the driver requests in StandardAllocationType.

AllocationPrivateDriverDataSize

[out] The size, in bytes, of the allocation private data that pAllocationPrivateDriverData points to. If the driver sets pAllocationPrivateDriverData to NULL, the driver should set AllocationPrivateDriverDataSize to the size of the buffer that the driver requires to describe the given standard allocation type.

If the driver does not use private data for each allocation for standard allocations types, the driver can set AllocationPrivateDriverDataSize to zero.

pResourcePrivateDriverData

[in/out] A pointer to a block of resource private data that describes the standard allocation type; otherwise, this member is NULL. The resource private data that the display miniport driver's DxgkDdiGetStandardAllocationDriverData function returns depends on the type that the driver requests in StandardAllocationType.

ResourcePrivateDriverDataSize

[out] The size, in bytes, of the resource private data that pResourcePrivateDriverData points to. If the driver sets pResourcePrivateDriverData to NULL, the driver should set ResourcePrivateDriverDataSize to the size of the buffer that the driver requires to describe the given standard allocation type.

If the driver does not use private data for each resource for standard allocations types, the driver can set ResourcePrivateDriverDataSize to zero.

Remarks

If the display miniport driver returns NULL in the pAllocationPrivateDriverData and pResourcePrivateDriverData members, the driver should return the sizes of the buffers that the driver requires in the AllocationPrivateDriverDataSize and ResourcePrivateDriverDataSize members. However, the driver should not change the contents of the standard allocation structure in the union that DXGKARG_GETSTANDARDALLOCATIONDRIVERDATA contains to obtain the required sizes of the buffers.

Although the driver can set ResourcePrivateDriverDataSize or AllocationPrivateDriverDataSize to zero, the driver cannot set both to zero.

Requirements

Version

Available in Windows Vista and later versions of the Windows operating systems.

Header

D3dkmddi.h (include D3dkmddi.h)

See also

D3DKMDT_GDISURFACEDATA
D3DKMDT_SHADOWSURFACEDATA
D3DKMDT_SHAREDPRIMARYSURFACEDATA
D3DKMDT_STAGINGSURFACEDATA
D3DKMDT_STANDARDALLOCATION_TYPE
DxgkDdiGetStandardAllocationDriverData

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft