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

Статья
08/07/2023

Структура D3D11DDIARG_CREATERESOURCE описывает создаваемый ресурс.

Синтаксис

typedef struct D3D11DDIARG_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;
  [in]      UINT                                 ByteStride;
  [in]      D3D11_1DDI_VIDEO_DECODER_BUFFER_TYPE DecoderBufferType;
            D3DWDDM2_0DDI_TEXTURE_LAYOUT         TextureLayout;
} D3D11DDIARG_CREATERESOURCE;

Члены

[in] pMipInfoList

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

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

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

[in, pPrimaryDesc

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

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

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

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

[in] ByteStride

Размер (в байтах) от одной строки сканирования до следующей линии сканирования в поверхности.

[in] DecoderBufferType

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

Если драйвер не проверка, что D3D11DDI_MINOR_HEADER_VERSION >= 3 перед доступом к этому элементу структуры, он должен обращаться к этому элементу только в том случае, если флаг D3D11_DDI_BIND_DECODER установлен в элементе BindFlags.

TextureLayout