Expand Minimize

D3DDDI_ALLOCATIONLIST structure

The D3DDDI_ALLOCATIONLIST structure describes information about an allocation specification that is used in direct memory access (DMA) buffering.

Syntax


typedef struct _D3DDDI_ALLOCATIONLIST {
  D3DKMT_HANDLE hAllocation;
  union {
    struct {
      UINT WriteOperation  :1;
      UINT DoNotRetireInstance  :1;
#if ((DXGKDDI_INTERFACE_VERSION >= DXGKDDI_INTERFACE_VERSION_WIN8) || \
     (D3D_UMD_INTERFACE_VERSION >= D3D_UMD_INTERFACE_VERSION_WIN8))

      UINT OfferPriority  :3;
#else 
      UINT Reserved  :27;
#endif 
      UINT Reserved  :30;
    };
    UINT Value;
  };
} D3DDDI_ALLOCATIONLIST;

Members

hAllocation

[in] The allocation handle returned by the D3DKMTOpenResource function in the hAllocation member of the D3DDDI_OPENALLOCATIONINFO structure, or by the D3DKMTCreateAllocation function in the hAllocation member of the D3DDDI_ALLOCATIONINFO structure.

WriteOperation

[in] A UINT that can hold information about whether the allocation can be written to. Setting to 1 indicates the allocation can be written to.

Setting this member is equivalent to setting the first bit of the 32-bit Value member (0x00000001).

DoNotRetireInstance

[in] A UINT that can hold information about whether the allocation can be retired. Setting to 1 indicates that the video memory manager should not retire the instance of the allocation because the driver will reference it again in a subsequent DMA buffer (for example, a manual broadcast of a DMA buffer to multiple contexts). All instances of an allocation are eventually retired. This flag is rarely used.

Setting this member is equivalent to setting the second bit of the 32-bit Value member (0x00000002).

OfferPriority

[in] A value from the D3DDDI_OFFER_PRIORITY enumeration that indicates the importance of video memory resources that the user-mode display driver offers for reuse.

If OfferPriority does not have a value of D3DDDI_OFFER_PRIORITY_NONE, the allocation is considered to be offered after the DMA buffer is processed.

Setting this member is equivalent to setting bits 3 through 5 of the 32-bit Value member (0x0000001C).

Supported starting with Windows 8.

Reserved

[in] This member is reserved and should be set to zero.

Setting this member to zero is equivalent to setting the remaining 27 bits (0xFFFFFFE0) of the 32-bit Value member to zeros.

Supported starting with Windows 8.

Reserved

[in] This member is reserved and should be set to zero.

Setting this member to zero is equivalent to setting the remaining 30 bits (0xFFFFFFFC) of the 32-bit Value member to zeros.

Value

[in] A 32-bit value that identifies information about an allocation specification used in DMA buffering.

Requirements

Version

Available starting with Windows Vista.

Header

D3dukmdt.h (include D3dumddi.h or D3dkmddi.h)

See also

CreateDevice
D3DDDIARG_CREATEDEVICE
D3DDDI_OFFER_PRIORITY
D3DDDICB_RENDER
pfnRenderCb

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft