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) |