estrutura D3D11DDIARG_CREATERESOURCE (d3d10umddi.h)

Artigo
02/22/2024

A estrutura D3D11DDIARG_CREATERESOURCE descreve um recurso a ser criado.

Sintaxe

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;

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 do tipo 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 do tipo 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 o membro ArraySize da estrutura D3D11DDIARG_CREATERESOURCE 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 de copy-style (transferência de bloco de bits) presentes.

[in] ByteStride

O tamanho, em bytes, de uma linha de verificação para a próxima linha de verificação na superfície.

[in] DecoderBufferType

Um valor do tipo D3D11_DDI_VIDEO_DECODER_BUFFER_TYPE que indica o tipo de buffer usado pelo decodificador de vídeo.

Se o driver não marcar esse D3D11DDI_MINOR_HEADER_VERSION >= 3 antes de acessar esse membro de estrutura, ele deverá acessar esse membro somente quando o sinalizador D3D11_DDI_BIND_DECODER estiver definido no membro BindFlags.

TextureLayout