D3DX11_IMAGE_LOAD_INFO 结构

（可选）向纹理加载程序 API 提供信息，以控制纹理的加载方式。 对于任何这些参数，如果值为 D3DX11_DEFAULT，则会导致 D3DX 自动使用源文件中的值。

语法

typedef struct D3DX11_IMAGE_LOAD_INFO {
  UINT              Width;
  UINT              Height;
  UINT              Depth;
  UINT              FirstMipLevel;
  UINT              MipLevels;
  D3D11_USAGE       Usage;
  UINT              BindFlags;
  UINT              CpuAccessFlags;
  UINT              MiscFlags;
  DXGI_FORMAT       Format;
  UINT              Filter;
  UINT              MipFilter;
  D3DX11_IMAGE_INFO *pSrcInfo;
} D3DX11_IMAGE_LOAD_INFO, *LPD3DX11_IMAGE_LOAD_INFO;

成员

Width

类型： UINT

纹理的目标宽度。 如果纹理的实际宽度大于或小于此值，则会纵向或缩小纹理以适应此目标宽度。

Height

类型： UINT

纹理的目标高度。 如果纹理的实际高度大于或小于此值，则将纵向或缩小纹理以适应此目标高度。

Depth

类型： UINT

纹理的深度。 这仅适用于卷纹理。

FirstMipLevel

类型： UINT

纹理的最高分辨率 mipmap 级别。 如果此值大于 0，则在加载纹理后，FirstMipLevel 将映射到 mipmap 级别 0。

MipLevels

类型： UINT

纹理中的最大 mipmap 级别数。 请参阅 D3D11_TEX1D_SRV中的备注。 使用 0 或 D3DX11_DEFAULT将导致创建完整的 mipmap 链。

使用情况

类型： D3D11_USAGE

纹理资源的使用方式。 请参阅 D3D11_USAGE。

BindFlags

类型： UINT

将允许纹理绑定到的管道阶段。 请参阅 D3D11_BIND_FLAG。

CpuAccessFlags

类型： UINT

CPU 对纹理资源的访问权限。 请参阅 D3D11_CPU_ACCESS_FLAG。

杂项Flags

类型： UINT

其他资源属性 (请参阅 D3D11_RESOURCE_MISC_FLAG) 。

格式

类型： DXGI_FORMAT

一个DXGI_FORMAT枚举，指示加载纹理后将采用的格式。

Filter

类型： UINT

仅当重新采样) 时，才使用指定的筛选器 (筛选纹理。 请参阅 D3DX11_FILTER_FLAG。

MipFilter

类型： UINT

仅当) 生成 mipmap 时，才使用指定的筛选器 (筛选纹理 mip 级别。 有效值为D3DX11_FILTER_NONE、D3DX11_FILTER_POINT、D3DX11_FILTER_LINEAR或D3DX11_FILTER_TRIANGLE。 请参阅 D3DX11_FILTER_FLAG。

pSrcInfo

类型： D3DX11_IMAGE_INFO*

有关原始图像的信息。 请参阅 D3DX11_IMAGE_INFO。 可以使用 D3DX11GetImageInfoFromFile、 D3DX11GetImageInfoFromMemory 或 D3DX11GetImageInfoFromResource 获取。

备注

初始化结构时，可以将任何成员设置为 D3DX11_DEFAULT并且 D3DX 会在加载纹理时使用源纹理中的默认值对其进行初始化。

此结构可由以下 API 使用：

• 创建资源，例如 D3DX11CreateTextureFromFile 和 D3DX11CreateShaderResourceViewFromFile。
• 创建数据处理者，例如 D3DX11CreateAsyncTextureInfoProcessor 或 D3DX11CreateAsyncShaderResourceViewProcessor。

默认值为：

    Width = D3DX11_DEFAULT;
    Height = D3DX11_DEFAULT;
    Depth = D3DX11_DEFAULT;
    FirstMipLevel = D3DX11_DEFAULT;
    MipLevels = D3DX11_DEFAULT;
    Usage = (D3D11_USAGE) D3DX11_DEFAULT;
    BindFlags = D3DX11_DEFAULT;
    CpuAccessFlags = D3DX11_DEFAULT;
    MiscFlags = D3DX11_DEFAULT;
    Format = DXGI_FORMAT_FROM_FILE;
    Filter = D3DX11_DEFAULT;
    MipFilter = D3DX11_DEFAULT;
    pSrcInfo = NULL;

下面是一个简短的示例，它使用此结构在加载纹理时提供像素格式。 有关完整代码，请参阅 HDRToneMappingCS11 中的 HDRFormats10.cpp 示例。

ID3D11ShaderResourceView* pCubeRV = NULL;
WCHAR strPath[MAX_PATH];
D3DX11_IMAGE_LOAD_INFO LoadInfo;

    DXUTFindDXSDKMediaFileCch( strPath, MAX_PATH, 
        L"Light Probes\\uffizi_cross.dds" );

    LoadInfo.Format = DXGI_FORMAT_R16G16B16A16_FLOAT;

    hr = D3DX11CreateShaderResourceViewFromFile( pd3dDevice, strPath, 
        &LoadInfo, NULL, &pCubeRV, NULL );

要求

请参阅

D3DX 结构