структура D3DDDI_ALLOCATIONLIST (d3dukmdt.h)

Статья
02/23/2024

Структура 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] Дескриптор выделения, возвращаемый функцией D3DKMTOpenResource в элементе hAllocationструктуры D3DDDI_OPENALLOCATIONINFO или функцией D3DKMTCreateAllocation в элементе hAllocationструктуры D3DDDI_ALLOCATIONINFO .

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–5 32-разрядного элемента Value (0x0000001C).

Поддерживается начиная с Windows 8.

Reserved

[in] Этот элемент зарезервирован и должен иметь нулевое значение.

Value

[in] 32-разрядное значение, определяющее сведения о спецификации выделения, используемой при буферизации DMA.