D3D10DDIARG_CREATERESOURCE 结构 (d3d10umddi.h)

项目
02/26/2024

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， 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指示资源绑定方式的值的有效按位 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 表示运行时将使用创建的资源作为主要 (即，在翻转样式的演示操作中，将资源扫描到显示) 。

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

如果 pPrimaryDesc 设置为 NULL，运行时将在复制样式 (位块传输) 现有操作中使用创建的资源。