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

包含 MIP 级别的维度的 D3D10DDI_MIPINFO 结构的数组。对于不能使用字节地址直接引用单个像素或纹素的资源格式，物理资源的维度通常大于或等于纹素维度，以满足必要的空间要求。例如，若要创建完全 mipped 的 BC1 Texture2D，其中最详细的级别为 8x8， pMipInfoList 数组为： { { 8， 8， 1， 8， 8， 1 }， { 4， 4， 1， 4， 1 }， { 2， 2， 1， 4， 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 OR 值。

[in] MapFlags

D3D10_DDI_MAP 类型的值，指示要映射到资源的访问级别。

[in] MiscFlags

指示有关资源的其他信息的 D3D10_DDI_RESOURCE_MISC_FLAG 值的有效按位 OR。

[in] Format

DXGI_FORMAT 类型的值，该值指示资源的像素格式。

[in] SampleDesc

描述资源样本计数和质量的 DXGI_SAMPLE_DESC 类型的值。

[in] MipLevels

资源的 MIP 映射级别数。

[in] ArraySize

二维纹理或一维纹理的数组元素数。对于多维数据集纹理，ArraySize 必须设置为 6。

从 Windows 8 开始，如果驱动程序必须创建立体声后退缓冲区，则应将此成员设置为值 2。

[in, pPrimaryDesc

指向描述用作主要资源的 DXGI_DDI_PRIMARY_DESC 结构的指针。

仅当在 bindFlags 成员中设置D3D10_DDI_BIND_PRESENT位时，Microsoft Direct3D 运行时才会 将 pPrimaryDesc 设置为非 NULL 值;但是，即使设置了D3D10_DDI_BIND_PRESENT，运行时也不会始终将 pPrimaryDesc 设置为非 NULL。将 pPrimaryDesc 设置为非 NULL 表示运行时将使用创建的资源作为主要资源（即，将资源扫描到显示），并在翻转样式的演示作中。

用户模式显示驱动程序可以返回 DriverFlags DXGI_DDI_PRIMARY_DESC 成员中的DXGI_DDI_PRIMARY_DRIVER_FLAG_NO_SCANOUT标志，以防止运行时执行翻转样式呈现作。

如果 pPrimaryDesc 设置为 NULL，运行时将使用复制样式（位块传输）当前作中创建的资源。