estructura D3D10DDIARG_CREATERESOURCE (d3d10umddi.h)

Artículo
06/08/2023

D3D10DDIARG_CREATERESOURCE contiene los argumentos utilizados por PFND3D10DDI_CREATERESOURCE para crear un recurso.

Sintaxis

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;

Miembros

[in] pMipInfoList

Matriz de estructuras de D3D10DDI_MIPINFO que contiene dimensiones para los niveles de MIP. En el caso de los formatos de recursos en los que no se puede hacer referencia directamente a un píxel o un elemento de textura directamente con una dirección de bytes, las dimensiones del recurso físico suelen ser mayores o iguales a las dimensiones de textura, con el fin de satisfacer los requisitos de espacio necesarios. Por ejemplo, para crear una textura BC1 totalmente miada2D, donde el nivel más detallado es 8x8, la matriz pMipInfoList es: { { 8, 8, 1, 8, 8, 1 }, { 4, 4, 1, 4, 4, 1 }, { 2, 2, 1, 4, 4, 4, 1 }, { 1, 1, 4, 1 } }.

[in] pInitialDataUP

Matriz de estructuras de D3D10_DDIARG_SUBRESOURCE_UP que proporciona información de inicialización para la lista de subrecursos del recurso.

[in] ResourceDimension

Valor de tipo D3D10DDIRESOURCE_TYPE que indica el tipo de recurso y la dimensionalidad.

[in] Usage

Valor de tipo D3D10_DDI_RESOURCE_USAGE que indica cómo se usa el recurso.

[in] BindFlags

OR bit a bit válido de D3D10_DDI_RESOURCE_BIND_FLAG valores que indican cómo está enlazado el recurso.

[in] MapFlags

Valor de tipo D3D10_DDI_MAP que indica el nivel de acceso que se va a asignar al recurso.

[in] MiscFlags

OR bit a bit válido de D3D10_DDI_RESOURCE_MISC_FLAG valores que indican información varias sobre el recurso.

[in] Format

Valor de tipo DXGI_FORMAT que indica el formato de píxel del recurso.

[in] SampleDesc

Valor de tipo DXGI_SAMPLE_DESC que describe el recuento de muestras y la calidad del recurso.

[in] MipLevels

Número de niveles de mapa de MIP para el recurso.

[in] ArraySize

Número de elementos de matriz para una textura 2D o textura 1D. ArraySize debe establecerse en 6 para una textura de cubo.

A partir de Windows 8, si el controlador debe crear un búfer de retroceso estéreo, debe establecer este miembro en un valor de 2.

[in, pPrimaryDesc

Puntero a una estructura de DXGI_DDI_PRIMARY_DESC que describe un recurso que se usa como principal.

El tiempo de ejecución de Microsoft Direct3D establece pPrimaryDesc en un valor distinto de NULL solo si el bit de D3D10_DDI_BIND_PRESENT está establecido en el miembro BindFlags ; Sin embargo, incluso si se establece D3D10_DDI_BIND_PRESENT, el tiempo de ejecución no siempre establece pPrimaryDesc en distinto de NULL. Establecer pPrimaryDesc en distinto de NULL indica que el tiempo de ejecución usará el recurso creado como principal (es decir, el recurso se examina en la pantalla) y en las operaciones presentes de estilo invertido.

El controlador de pantalla en modo de usuario puede devolver la marca de DXGI_DDI_PRIMARY_DRIVER_FLAG_NO_SCANOUT en el miembro DriverFlags de DXGI_DDI_PRIMARY_DESC para evitar que el tiempo de ejecución realice operaciones de estilo invertida presentes.

Si pPrimaryDesc está establecido en NULL, el entorno de ejecución usará el recurso creado en las operaciones presentes de estilo de copia (transferencia de bloques de bits).