> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# D3D12XBOX_SHADER_RESOURCE_VIEW_DESC (consoles XBOX Series)

> D3D12XBOX_SHADER_RESOURCE_VIEW_DESC define uma SRV nos consoles XBOX Series, usando o ImageFormat unificado e campos de localização de recursos e de memória exclusivos do XBOX.

Descreve uma exibição de recurso de sombreador (SRV).

## Sintaxe

```cpp theme={null}
typedef struct D3D12XBOX_SHADER_RESOURCE_VIEW_DESC {  
    DXGI_FORMAT Format;  
    D3D12_SRV_DIMENSION ViewDimension;  
    UINT Shader4ComponentMapping;  
    union  
    {  
        D3D12_BUFFER_SRV Buffer;  
        D3D12_TEX1D_SRV Texture1D;  
        D3D12_TEX1D_ARRAY_SRV Texture1DArray;  
        D3D12_TEX2D_SRV Texture2D;  
        D3D12_TEX2D_ARRAY_SRV Texture2DArray;  
        D3D12_TEX2DMS_SRV Texture2DMS;  
        D3D12_TEX2DMS_ARRAY_SRV Texture2DMSArray;  
        D3D12_TEX3D_SRV Texture3D;  
        D3D12_TEXCUBE_SRV TextureCube;  
        D3D12_TEXCUBE_ARRAY_SRV TextureCubeArray;  
    };  
    D3D12_GPU_VIRTUAL_ADDRESS ResourceLocation;  
    D3D12XBOX_IMAGE_FORMAT ImageFormat;  
    UINT MemoryType;  
    FLOAT TextureWarnLevelOfDetail;  
    INT TexturePerfModulation;  
} D3D12XBOX_SHADER_RESOURCE_VIEW_DESC  
```

### Membros

*Format*\
Tipo: [DXGI\_FORMAT](/pt-BR/reference/graphics/d3d12_xs/enums/dxgi_format)

O formato de exibição do recurso. Para obter mais informações, consulte a seção Comentários.

*ViewDimension*\
Tipo: [D3D12\_SRV\_DIMENSION](/pt-BR/reference/graphics/d3d12_x/enums/d3d12_srv_dimension)

O tipo de recurso de sombreador da exibição. Esse tipo é o mesmo que o tipo de recurso do recurso subjacente. Este membro determina o tipo de dados armazenados na união Buffer/Texture1D/Texture2D/etc abaixo.

*Shader4ComponentMapping*\
Tipo: UINT

Uma constante de enumeração [D3D12\_SHADER\_COMPONENT\_MAPPING](https://learn.microsoft.com/en-us/windows/desktop/api/d3d12/ne-d3d12-d3d12_shader_component_mapping) que especifica como uma exibição de recurso de sombreador (SRV) roteia a memória para os componentes de retorno em um sombreador após uma busca de memória.

*Buffer*\
Tipo: [D3D12\_BUFFER\_SRV](https://learn.microsoft.com/en-us/windows/desktop/api/d3d12/ns-d3d12-d3d12_buffer_srv)

Uma estrutura **D3D12\_BUFFER\_SRV** que exibe o recurso como um buffer.

*Texture1D*\
Tipo: [D3D12\_TEX1D\_SRV](https://learn.microsoft.com/en-us/windows/desktop/api/d3d12/ns-d3d12-d3d12_tex1d_srv)

Uma estrutura **D3D12\_TEX1D\_SRV** que exibe o recurso como uma textura 1D.

*Texture1DArray*\
Tipo: [D3D12\_TEX1D\_ARRAY\_SRV](https://learn.microsoft.com/en-us/windows/desktop/api/d3d12/ns-d3d12-d3d12_tex1d_array_srv)

Uma estrutura **D3D12\_TEX1D\_ARRAY\_SRV** que exibe o recurso como uma matriz de texturas 1D.

*Texture2D*\
Tipo: [D3D12\_TEX2D\_SRV](https://learn.microsoft.com/en-us/windows/desktop/api/d3d12/ns-d3d12-d3d12_tex2d_srv)

Uma estrutura **D3D12\_TEX2D\_SRV** que exibe o recurso como uma textura 2D.

*Texture2DArray*\
Tipo: [D3D12\_TEX2D\_ARRAY\_SRV](https://learn.microsoft.com/en-us/windows/desktop/api/d3d12/ns-d3d12-d3d12_tex2d_array_srv)

Uma estrutura **D3D12\_TEX2D\_ARRAY\_SRV** que exibe o recurso como uma matriz de texturas 2D.

*Texture2DMS*\
Tipo: [D3D12\_TEX2DMS\_SRV](https://learn.microsoft.com/en-us/windows/desktop/api/d3d12/ns-d3d12-d3d12_tex2dms_srv)

Uma estrutura **D3D12\_TEX2DMS\_SRV** que exibe o recurso como uma textura 2D multiamostrada.

*Texture2DMSArray*\
Tipo: [D3D12\_TEX2DMS\_ARRAY\_SRV](https://learn.microsoft.com/en-us/windows/desktop/api/d3d12/ns-d3d12-d3d12_tex2dms_array_srv)

Uma estrutura **D3D12\_TEX2DMS\_ARRAY\_SRV** que exibe o recurso como uma matriz de texturas 2D multiamostradas.

*Texture3D*\
Tipo: [D3D12\_TEX3D\_SRV](https://learn.microsoft.com/en-us/windows/desktop/api/d3d12/ns-d3d12-d3d12_tex3d_srv)

Uma estrutura **D3D12\_TEX3D\_SRV** que exibe o recurso como uma textura 3D.

*TextureCube*\
Tipo: [D3D12\_TEXCUBE\_SRV](https://learn.microsoft.com/en-us/windows/desktop/api/d3d12/ns-d3d12-d3d12_texcube_srv)

Uma estrutura **D3D12\_TEXCUBE\_SRV** que exibe o recurso como uma textura de cubo 3D.

*TextureCubeArray*\
Tipo: [D3D12\_TEXCUBE\_ARRAY\_SRV](https://learn.microsoft.com/en-us/windows/desktop/api/d3d12/ns-d3d12-d3d12_texcube_array_srv)

Uma estrutura **D3D12\_TEXCUBE\_ARRAY\_SRV** que exibe o recurso como uma matriz de texturas de cubo 3D.

*ResourceLocation*\
Tipo: [D3D12\_GPU\_VIRTUAL\_ADDRESS](https://learn.microsoft.com/en-us/windows/desktop/direct3d12/d3d12_gpu_virtual_address)

(XBOX; não disponível no PC) A localização do recurso.

*ImageFormat*\
Tipo: [D3D12XBOX\_IMAGE\_FORMAT](/pt-BR/reference/graphics/d3d12_xs/enums/d3d12xbox_image_format)

(XBOX; não disponível no PC) Os dados da imagem e o formato numérico como uma constante de enumeração **D3D12XBOX\_IMAGE\_FORMAT**.

*MemoryType*\
Tipo: UINT

(XBOX One; não disponível no PC) O tipo de memória. Reservado e definido como zero.

*TextureWarnLevelOfDetail*\
Tipo: FLOAT

(XBOX One; não disponível no PC) O nível de detalhe de uma textura no qual uma mensagem de aviso é emitida.

*TexturePerfModulation*\
Tipo: INT

(XBOX One; não disponível no PC) A modulação de desempenho da textura.

## Comentários

Uma exibição é uma maneira específica de formato de observar os dados em um recurso. A exibição determina quais dados observar e como eles são convertidos quando lidos.

Ao exibir um recurso, a descrição da exibição de recurso deve especificar um formato tipado compatível com o formato do recurso. Isso significa que você não pode criar uma descrição de exibição de recurso usando qualquer formato com \_TYPELESS no nome. No entanto, você pode exibir um recurso sem tipo especificando um formato tipado para a exibição. Por exemplo, um recurso **DXGI\_FORMAT\_R32G32B32\_TYPELESS** pode ser exibido com um destes formatos tipados: **DXGI\_FORMAT\_R32G32B32\_FLOAT**, **DXGI\_FORMAT\_R32G32B32\_UINT** e **DXGI\_FORMAT\_R32G32B32\_SINT**, já que esses formatos tipados são compatíveis com o recurso sem tipo. Para obter mais informações sobre formatos de exibição de recursos, consulte [DXGI\_FORMAT](https://learn.microsoft.com/en-us/windows/desktop/api/dxgiformat/ne-dxgiformat-dxgi_format).

Essa estrutura é usada por [ID3D12Device::CreatePlacedShaderResourceViewX](/pt-BR/reference/graphics/d3d12_x/interfaces/id3d12device/methods/id3d12device_createplacedshaderresourceviewx) e [ID3D12Device::CreatePlacedRawShaderResourceViewX](/pt-BR/reference/graphics/d3d12_x/interfaces/id3d12device/methods/id3d12device_createplacedrawshaderresourceviewx).

## Requisitos

**Cabeçalho:** d3d12\_xs.h\
**Plataformas compatíveis**: consoles XBOX Series

## Confira também

[d3d12\_xs](/pt-BR/reference/graphics/d3d12_xs/d3d12_xs_members)


## Related topics

- [Répertoire des rubriques NDA : liens actifs vers Microsoft Learn](/fr/nda/nda-topic-directory.md)
- [Diretório de tópicos NDA: links ativos do Microsoft Learn](/pt-BR/nda/nda-topic-directory.md)
- [D3D12_SHADER_RESOURCE_VIEW_DESC](/reference/graphics/d3d12/structs/d3d12_shader_resource_view_desc_public.md)
- [D3D12_DISPATCH_RAYS_DESC (XBOX Series consoles)](/reference/graphics/d3d12/structs/d3d12_dispatch_rays_desc_public.md)