D3DDDI_ALLOCATIONLIST structure (d3dukmdt.h)

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;
      UINT OfferPriority : 3;
#if ...
      UINT Reserved : 27;
#else
      UINT Reserved : 30;
#endif
    };
    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.

Value

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

Requirements

Requirement Value
Minimum supported client Windows Vista
Header d3dukmdt.h (include D3dumddi.h, D3dkmddi.h)

See also

CreateDevice

D3DDDIARG_CREATEDEVICE

D3DDDICB_RENDER

D3DDDI_OFFER_PRIORITY

pfnRenderCb