estrutura D3D10DDIARG_CREATERESOURCE (d3d10umddi.h)

Artigo
06/08/2023

D3D10DDIARG_CREATERESOURCE contém os argumentos usados pelo PFND3D10DDI_CREATERESOURCE para criar um recurso.

Sintaxe

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;

Membros

[in] pMipInfoList

Uma matriz de estruturas de D3D10DDI_MIPINFO que contém dimensões para níveis de MIP. Para formatos de recurso em que um único pixel ou texel não pode ser referenciado diretamente com um endereço de byte, as dimensões do recurso físico normalmente são maiores ou iguais às dimensões texel, a fim de atender aos requisitos de espaço necessários. Por exemplo, para criar um BC1 Texture2D totalmente mapeado, em que o nível mais detalhado é 8x8, a matriz pMipInfoList é: { { 8, 8, 1, 8, 8, 1 }, { 4, 4, 1, 4, 4, 1 }, { 2, 2, 1, 4, 4, 1 }, { 1, 1, 1, 4, 4, 1 } }.

[in] pInitialDataUP

Uma matriz de estruturas de D3D10_DDIARG_SUBRESOURCE_UP que fornece informações de inicialização para a lista de sub-recursos do recurso.

[in] ResourceDimension

Um valor do tipo D3D10DDIRESOURCE_TYPE que indica o tipo de recurso e a dimensionalidade.

[in] Usage

Um valor do tipo D3D10_DDI_RESOURCE_USAGE que indica como o recurso é usado.

[in] BindFlags

Um OR bit a bit válido de valores de D3D10_DDI_RESOURCE_BIND_FLAG que indica como o recurso está associado.

[in] MapFlags

Um valor do tipo D3D10_DDI_MAP que indica o nível de acesso a ser mapeado para o recurso.

[in] MiscFlags

Um OR bit a bit válido de valores de D3D10_DDI_RESOURCE_MISC_FLAG que indica informações diversas sobre o recurso.

[in] Format

Um valor do tipo DXGI_FORMAT que indica o formato de pixel do recurso.

[in] SampleDesc

Um valor do tipo DXGI_SAMPLE_DESC que descreve a contagem de exemplo e a qualidade do recurso.

[in] MipLevels

O número de níveis de mapa MIP para o recurso.

[in] ArraySize

O número de elementos de matriz para uma textura 2D ou textura 1D. ArraySize deve ser definido como 6 para uma textura de cubo.

A partir de Windows 8, se o driver precisar criar um buffer traseiro estéreo, ele deverá definir esse membro como um valor de 2.

[in, pPrimaryDesc

Um ponteiro para uma estrutura de DXGI_DDI_PRIMARY_DESC que descreve um recurso usado como primário.

O runtime do Microsoft Direct3D define pPrimaryDesc como um valor não NULL somente se o bit D3D10_DDI_BIND_PRESENT for definido no membro BindFlags ; no entanto, mesmo que D3D10_DDI_BIND_PRESENT esteja definido, o runtime nem sempre define pPrimaryDesc como não NULL. Definir pPrimaryDesc como não NULL indica que o runtime usará o recurso criado como primário (ou seja, o recurso é verificado para a exibição) e em operações presentes no estilo flip.

O driver de exibição do modo de usuário pode retornar o sinalizador DXGI_DDI_PRIMARY_DRIVER_FLAG_NO_SCANOUT no membro DriverFlags do DXGI_DDI_PRIMARY_DESC para impedir que o runtime execute operações presentes no estilo flip.

Se pPrimaryDesc estiver definido como NULL, o runtime usará o recurso criado em operações presentes no estilo de cópia (transferência de bloco de bits).