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
包含 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 开始,如果驱动程序必须创建立体声后退缓冲区,则应将 D3D11DDIARG_CREATERESOURCE 结构的 ArraySize 成员设置为值 2。
[in, pPrimaryDesc
指向描述用作主要资源的 DXGI_DDI_PRIMARY_DESC 结构的指针。
仅当在 bindFlags 成员 中设置D3D10_DDI_BIND_PRESENT位时,Microsoft Direct3D 运行时才会 将 pPrimaryDesc 设置为非 NULL 值;但是,即使设置了D3D10_DDI_BIND_PRESENT,运行时也不会始终将 pPrimaryDesc 设置为非 NULL。 将 pPrimaryDesc 设置为非 NULL 表示运行时将使用创建的资源作为主要资源(即,将资源扫描到显示),并在翻转样式的演示作中。
用户模式显示驱动程序可以返回 DriverFlagsDXGI_DDI_PRIMARY_DESC 成员中的 DXGI_DDI_PRIMARY_DRIVER_FLAG_NO_SCANOUT 标志,以防止运行时执行翻转样式呈现作。
如果 pPrimaryDesc 设置为 NULL,运行时将使用创建的资源;复制样式(位块传输)存在作。
[in] ByteStride
大小(以字节为单位)从一个扫描行到图面中的下一个扫描行。
[in] DecoderBufferType
D3D11_DDI_VIDEO_DECODER_BUFFER_TYPE 类型的值,指示视频解码器使用的缓冲区类型。
如果驱动程序在访问此结构成员之前未检查 D3D11DDI_MINOR_HEADER_VERSION >= 3,则仅当 BindFlags 成员中设置D3D11_DDI_BIND_DECODER标志时,它才应访问此成员。
TextureLayout
要求
| 要求 | 价值 |
|---|---|
| 最低支持的客户端 | Windows 7 (WDDM 1.1) |
| 标头 | d3d10umddi.h (包括 D3d10umddi.h) |