D3DDDI_ALLOCATIONLIST 結構 (d3dukmdt.h)
D3DDDI_ALLOCATIONLIST結構描述直接記憶體存取 (DMA) 緩衝中使用的配置規格相關信息。
語法
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;
成員
hAllocation
[in]D3DDDI_OPENALLOCATIONINFO 結構的 hAllocation 成員中 D3DKMTOpenResource 函式所傳回的配置句柄，或由 D3DDDI_ALLOCATIONINFO 結構的 hAllocation 成員中的 D3DKMTCreateAllocation 函式所傳回。
WriteOperation
[in]UINT，可保存是否可以寫入配置的相關信息。 將設定為 1 表示可以寫入設定。
設定此成員相當於設定 32 位 Value 成員的第一個位 (0x00000001) 。
DoNotRetireInstance
[in]UINT，可保存是否可以淘汰配置的相關信息。 設定為 1 表示視訊記憶體管理員不應該淘汰配置的實例，因為驅動程式會在後續的 DMA 緩衝區中再次參考它，例如，手動將 DMA (緩衝區廣播至多個內容) 。 配置的所有實例最終都會淘汰。 此旗標很少使用。
設定此成員相當於設定 32 位 Value 成員的第二個位 (0x00000002) 。
OfferPriority
[in]來自 D3DDDI_OFFER_PRIORITY 列舉的值，指出使用者模式顯示驅動程式提供重複使用之視訊記憶體資源的重要性。
如果 OfferPriority 沒有 值D3DDDI_OFFER_PRIORITY_NONE，則會在處理 DMA 緩衝區之後，將配置視為提供。
設定此成員相當於將位 3 到 32 位 Value 成員的 3 到 5 設定 (0x0000001C) 。
從 Windows 8 開始支援。
Reserved
[in]這個成員是保留的，而且應該設定為零。
Value
[in]32 位值，識別 DMA 緩衝中使用的配置規格相關信息。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows Vista |
| 標頭 | d3dukmdt.h (包含 D3dumddi.h、D3dkmddi.h) |