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

Статья
10/25/2023

Структура D3DDDI_ALLOCATIONINFO описывает выделение для WDDM версии 1. Вместо этого графические клиенты пользовательского режима должны использовать D3DDDI_ALLOCATIONINFO2 .

Синтаксис

typedef struct _D3DDDI_ALLOCATIONINFO {
  D3DKMT_HANDLE                  hAllocation;
  void                           D3DKMT_PTR(
    const VOID *unnamedParam1,
    pSystemMem unnamedParam2
  );
  void                           D3DKMT_PTR(
    VOID               *unnamedParam1,
    pPrivateDriverData unnamedParam2
  );
  UINT                           PrivateDriverDataSize;
  D3DDDI_VIDEO_PRESENT_SOURCE_ID VidPnSourceId;
  union {
    struct {
      UINT Primary : 1;
      UINT Stereo : 1;
#if ...
      UINT Reserved : 30;
#else
      UINT Reserved : 31;
#endif
    };
    UINT Value;
  } Flags;
} D3DDDI_ALLOCATIONINFO;

Члены

hAllocation

[out] D3DKMT_HANDLE , представляющий дескриптор в режиме ядра для выделения. Этот дескриптор связан с дескриптором ресурса режима ядра (если оно не равно NULL), который функция pfnAllocateCb среды выполнения Direct3D возвращает в элементе hKMResourceструктуры D3DDDICB_ALLOCATE . Драйвер отображения пользовательского режима может использовать этот дескриптор выделения в режиме ядра для ссылки на выделение в буфере команд.

void D3DKMT_PTR( const VOID *unnamedParam1, pSystemMem unnamedParam2)

void D3DKMT_PTR( VOID *unnamedParam1, pPrivateDriverData unnamedParam2)

PrivateDriverDataSize

[in] Размер личных данных в байтах.

VidPnSourceId

[in] Отсчитываемый от нуля идентификационный номер VidPN источника видео в пути к топологии сети видеотрансляции (VidPN), если выделение предназначено для основной поверхности. Драйвер должен задавать VidPnSourceId только для основных типов выделения, а не для любого другого типа выделения. Если драйвер задает VidPnSourceId для любого другого типа выделения в вызове функции pfnAllocateCb , pfnAllocateCb возвращает D3DDDI_ID_NOTAPPLICABLE.

Когда подсистема графического ядра DirectX инициирует создание выделения для общей основной поверхности, драйвер мини-порта дисплея может определить идентификационный номер из элемента VidPnSourceIdструктуры D3DKMDDI_SHAREDPRIMARYSURFACEDATA , на которую указывает элемент pPrivateDriverDataструктуры DXGK_ALLOCATIONINFO .

Flags

[in] Объединение, содержащее структуру или 32-разрядное значение, определяющее тип выделения.

Flags.Primary

[in] UINT, указывающий, является ли выделение частью рабочего стола. Такое выделение неявно доступно ЦП. Основное выделение может быть закреплено при создании или не закреплено при создании.

Задание этого элемента эквивалентно установке первого бита 32-разрядного элемента Value (0x00000001).

Flags.Stereo

[in] Поддерживается начиная с Windows 8. UINT, указывающий, является ли выделение основным стерео. Элемент Stereo можно задать только в том случае, если задан основной элемент.

Задание этого элемента эквивалентно установке второго бита 32-разрядного элемента Value (0x00000002).

Flags.Reserved

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

Flags.Value

[in] 32-разрядное значение, определяющее тип выделения.

Когда драйвер отображения пользовательского режима устанавливает флаг основного битового поля в элементе Flags D3DDDI_ALLOCATIONINFO, к структуре DXGK_ALLOCATIONINFO в элементе pAllocationInfoструктуры DXGKARG_CREATEALLOCATION для выделения в вызове функции DxgkDdiCreateAllocation драйвера дисплея miniport. Ниже перечислены эти ограничения.

Выделение выделяется в соответствии с предпочтениями; В противном случае выделение по умолчанию использует поддерживаемый набор сегментов записи, а все указанные сегменты в наборе сегментов записи должны быть доступны ЦП.
Драйвер мини-порта дисплея не может задать следующие флаги битовых полей в элементе FlagsDXGK_ALLOCATIONINFO:
PermanentSysMem
Кэшировано
Защищенный
ExistingSysMem
ExistingKernelSysMem