estructura de D3D11_TEXTURE2D_DESC (d3d11.h)
Describe una textura 2D.
Sintaxis
typedef struct D3D11_TEXTURE2D_DESC {
UINT Width;
UINT Height;
UINT MipLevels;
UINT ArraySize;
DXGI_FORMAT Format;
DXGI_SAMPLE_DESC SampleDesc;
D3D11_USAGE Usage;
UINT BindFlags;
UINT CPUAccessFlags;
UINT MiscFlags;
} D3D11_TEXTURE2D_DESC;
Miembros
Width
Tipo: UINT
Ancho de textura (en elementos de textura). El intervalo es de 1 a D3D11_REQ_TEXTURE2D_U_OR_V_DIMENSION (16384). Para un mapa de cubo de textura, el intervalo va de 1 a D3D11_REQ_TEXTURECUBE_DIMENSION (16384). Sin embargo, el intervalo está realmente restringido por el nivel de característica en el que se crea el dispositivo de representación. Para obtener más información sobre las restricciones, vea Comentarios.
Height
Tipo: UINT
Alto de textura (en texturas). El intervalo es de 1 a D3D11_REQ_TEXTURE2D_U_OR_V_DIMENSION (16384). Para un mapa de cubo de textura, el intervalo va de 1 a D3D11_REQ_TEXTURECUBE_DIMENSION (16384). Sin embargo, el intervalo está realmente restringido por el nivel de característica en el que se crea el dispositivo de representación. Para obtener más información sobre las restricciones, vea Comentarios.
MipLevels
Tipo: UINT
Número máximo de niveles de mapa mip en la textura. Vea los comentarios en D3D11_TEX1D_SRV. Use 1 para una textura multimuestreo; o 0 para generar un conjunto completo de subtexturas.
ArraySize
Tipo: UINT
Número de texturas de la matriz de texturas. El intervalo es de 1 a D3D11_REQ_TEXTURE2D_ARRAY_AXIS_DIMENSION (2048). Para un mapa de cubo de textura, este valor es un múltiplo de 6 (es decir, 6 veces el valor del miembro NumCubes de D3D11_TEXCUBE_ARRAY_SRV) y el intervalo es de 6 a 2046. El intervalo está realmente restringido por el nivel de característica en el que se crea el dispositivo de representación. Para obtener más información sobre las restricciones, vea Comentarios.
Format
Tipo: DXGI_FORMAT
Formato de textura (consulte DXGI_FORMAT).
SampleDesc
Tipo: DXGI_SAMPLE_DESC
Estructura que especifica parámetros de muestreo múltiple para la textura. Consulte DXGI_SAMPLE_DESC.
Usage
Tipo: D3D11_USAGE
Valor que identifica cómo se va a leer y escribir la textura. El valor más común es D3D11_USAGE_DEFAULT; consulte D3D11_USAGE para ver todos los valores posibles.
BindFlags
Tipo: UINT
Marcas (consulte D3D11_BIND_FLAG) para enlazar a fases de canalización. Las marcas se pueden combinar mediante un OR bit a bit.
CPUAccessFlags
Tipo: UINT
Marcas (consulte D3D11_CPU_ACCESS_FLAG) para especificar los tipos de acceso de CPU permitidos. Use 0 si no se requiere acceso a la CPU. Estas marcas se pueden combinar con un OR bit a bit.
MiscFlags
Tipo: UINT
Marcas (consulte D3D11_RESOURCE_MISC_FLAG) que identifican otras opciones de recursos menos comunes. Use 0 si no se aplica ninguna de estas marcas. Estas marcas se pueden combinar mediante un OR bit a bit. Para un mapa de cubo de textura, establezca la marca de D3D11_RESOURCE_MISC_TEXTURECUBE . Las matrices de mapa de cubo (es decir, ArraySize> 6) requieren D3D_FEATURE_LEVEL_10_1 de nivel de característica o superior.
Comentarios
Esta estructura se usa en una llamada a ID3D11Device::CreateTexture2D.
Además de esta estructura, también puede usar la estructura derivada CD3D11_TEXTURE2D_DESC , que se define en D3D11.h y se comporta como una clase heredada, para ayudar a crear una descripción de textura.
El dispositivo coloca algunas restricciones de tamaño (debe ser múltiplo de un tamaño mínimo) para un recurso de formato de bits, comprimido en bloques o submuestreo.
El intervalo de tamaño de textura viene determinado por el nivel de característica en el que se crea el dispositivo y no la versión de la interfaz de Microsoft Direct3D. Por ejemplo, si usa hardware de Microsoft Direct3D 10 en el nivel de característica 10 (D3D_FEATURE_LEVEL_10_0) y llama a D3D11CreateDevice para crear un ID3D11Device, debe restringir el tamaño máximo de textura a D3D10_REQ_TEXTURE2D_U_OR_V_DIMENSION (8192) al crear la textura 2D.
Requisitos
| Requisito | Valor |
|---|---|
| Header | d3d11.h |