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

Consulte también

Estructuras de recursos