структура D3D10DDIARG_CREATERESOURCE (d3d10umddi.h)

Статья
02/06/2025

D3D10DDIARG_CREATERESOURCE содержит аргументы, используемые PFND3D10DDI_CREATERESOURCE для создания ресурса.

Синтаксис

typedef struct D3D10DDIARG_CREATERESOURCE {
  [in]      const D3D10DDI_MIPINFO            *pMipInfoList;
  [in]      const D3D10_DDIARG_SUBRESOURCE_UP *pInitialDataUP;
  [in]      D3D10DDIRESOURCE_TYPE             ResourceDimension;
  [in]      UINT                              Usage;
  [in]      UINT                              BindFlags;
  [in]      UINT                              MapFlags;
  [in]      UINT                              MiscFlags;
  [in]      DXGI_FORMAT                       Format;
  [in]      DXGI_SAMPLE_DESC                  SampleDesc;
  [in]      UINT                              MipLevels;
  [in]      UINT                              ArraySize;
  [in, out] DXGI_DDI_PRIMARY_DESC             *pPrimaryDesc;
} D3D10DDIARG_CREATERESOURCE;

Члены

[in] pMipInfoList

Массив D3D10DDI_MIPINFO структур, содержащих измерения для уровней MIP. Для форматов ресурсов, где один пиксель или тексель нельзя ссылаться непосредственно с адресом байтов, размеры физического ресурса обычно больше или равны измерениям текселя, чтобы удовлетворить необходимые требования к пространству. Например, чтобы создать полностью mipped BC1 Texture2D, где наиболее подробный уровень равен 8x8, массив pMipInfoList: { { 8, 8, 8, 8, 8, 8, 1 }, { 4, 4, 4, 4, 1 }, { 2, 2, 1, 4, 4, 1 }, { 1, 1, 1, 1, 1, 4, 1 }

[in] pInitialDataUP

Массив структур D3D10_DDIARG_SUBRESOURCE_UP, предоставляющий сведения о инициализации для списка подресурсов ресурса.

[in] ResourceDimension

Значение типа D3D10DDIRESOURCE_TYPE, указывающее тип ресурса и размерность.

[in] Usage

Значение типа D3D10_DDI_RESOURCE_USAGE, указывающее, как используется ресурс.

[in] BindFlags

Допустимый побитовый ИЛИ D3D10_DDI_RESOURCE_BIND_FLAG значений, указывающих, как привязан ресурс.

[in] MapFlags

Значение типа D3D10_DDI_MAP, указывающее уровень доступа для сопоставления с ресурсом.

[in] MiscFlags

Допустимый битовый ИЛИ значения D3D10_DDI_RESOURCE_MISC_FLAG, указывающие на другие сведения о ресурсе.

[in] Format

Значение типа DXGI_FORMAT, указывающее формат пикселя ресурса.

[in] SampleDesc

Значение типа DXGI_SAMPLE_DESC, описывающее количество выборок и качество ресурса.

[in] MipLevels

Количество уровней карты MIP для ресурса.

[in] ArraySize

Количество элементов массива для текстуры 2-D или 1-D. ArraySize должно иметь значение 6 для текстуры куба.

Начиная с Windows 8, если драйвер должен создать стерео буфер задней части, он должен задать для этого элемента значение 2.

[in, pPrimaryDesc

Указатель на структуру DXGI_DDI_PRIMARY_DESC, описывающую ресурс, используемый в качестве основного.

Среда выполнения Microsoft Direct3D задает pPrimaryDesc значение, отличное от NULL, только если D3D10_DDI_BIND_PRESENT бит задан в элементе BindFlags; однако даже если задано D3D10_DDI_BIND_PRESENT, среда выполнения не всегда задает pPrimaryDesc значение NULL. Параметр pPrimaryDesc не null указывает, что среда выполнения будет использовать созданный ресурс в качестве основного (т. е. отсканирован на экран) и в операциях представления в стиле перевернутого стиля.

Драйвер отображения в пользовательском режиме может вернуть флаг DXGI_DDI_PRIMARY_DRIVER_FLAG_NO_SCANOUT в элементе DriverFlags DriverFlags DXGI_DDI_PRIMARY_DESC, чтобы предотвратить выполнение операций представления в режиме выполнения.

Если pPrimaryDesc имеет значение NULL, среда выполнения будет использовать созданный ресурс в операциях копирования (передачи битовых блоков).