> ## 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.

# XGBVHComputer::DecompressBVH_BatchedGPU

> Descompacta uma ou mais BVHs usando a GPU

Descompacta uma ou mais BVHs usando a GPU.

<div class="alert">**OBSERVAÇÃO: esta API foi preterida e será removida no GDK de junho de 2024**</div>

Use `RehydrateRaytracingAccelerationStructureX` em vez dela.

## Sintaxe

```cpp theme={null}
HRESULT DecompressBVH_BatchedGPU(  
    _In_ ID3D12GraphicsCommandList* pCommandList,
    _In_reads_(NumDescs) const D3D12_BUILD_RAYTRACING_ACCELERATION_STRUCTURE_DESC Descs[],
    _In_ UINT32                     NumDescs
)  
```

### Parâmetros

*pCommandList*   \_In\_<br />Tipo: ID3D12GraphicsCommandList\*

Uma lista de comandos D3D12 na qual emitir o trabalho de computação

*Descs*   \_In\_<br />Tipo: const D3D12\_BUILD\_RAYTRACING\_ACCELERATION\_STRUCTURE\_DESC\[]

Uma matriz de descrições de BVH a serem descompactadas

*NumDescs*   \_In\_<br />Tipo: UINT32

O número de BVHs a serem descompactadas

### Valor retornado

Tipo: HRESULT

Retorna S\_OK se tiver êxito; caso contrário, retorna um código de erro. Para obter uma lista de códigos de erro, confira [Códigos de retorno do Direct3D 12](https://learn.microsoft.com/en-us/windows/win32/direct3d12/d3d12-graphics-reference-returnvalues).

## Comentários

Esta API requer um dispositivo D3D. Use [XGCreateBVHComputer2](/pt-BR/reference/graphics/xg_xs/functions/xgcreatebvhcomputer2_xs).

O formato descompactável pela GPU difere do formato descompactável pela CPU. Para garantir a compatibilidade com esta API, use D3D12XBOX\_RAYTRACING\_ACCELERATION\_STRUCTURE\_COPY\_MODE\_SERIALIZE\_AND\_COMPRESS\_FOR\_GPU em vez de D3D12XBOX\_RAYTRACING\_ACCELERATION\_STRUCTURE\_COPY\_MODE\_SERIALIZE\_AND\_COMPRESS com CopyRaytracingAccelerationStructure().

Cada BVH requer memória de rascunho para ser descompactada. O método relacionado, GetRequiredGpuScratchSizeInBytes(), deve ser usado para consultar quanta memória de GPU alocar para cada BVH. Atribua o ponteiro de rascunho com Desc.ScratchAccelerationStructureData.

Esta API não está disponível no driver offline.

<a id="requirements" />

## Requisitos

**Cabeçalho:** xg\_xs.h

**Biblioteca:** xg\_xs.lib<br />**Plataformas com suporte**: consoles XBOX Series

## Confira também

[XGBVHComputer](/pt-BR/reference/graphics/xg_xs/interfaces/XGBVHComputer/xgbvhcomputer_xs)<br />[XGCreateBVHComputer2](/pt-BR/reference/graphics/xg_xs/functions/xgcreatebvhcomputer2_xs)<br />[DecompressBVH](/pt-BR/reference/graphics/xg_xs/interfaces/XGBVHComputer/methods/xgbvhcomputer_decompressbvh_xs)<br />[GetRequiredGpuScratchSizeInBytes](/pt-BR/reference/graphics/xg_xs/interfaces/XGBVHComputer/methods/xgbvhcomputer_getrequiredgpuscratchsizeinbytes_xs)


## Related topics

- [Diretório de tópicos NDA: links ativos do Microsoft Learn](/pt-BR/nda/nda-topic-directory.md)
- [Diretrizes de classificação etária para países/regiões](/pt-BR/publishing/game-publishing/concepts/age-ratings-guidance.md)
- [Exemplo de token XSTS, descriptografia e validação](/pt-BR/services/xbox-services/fundamentals/s2s-auth-calls/service-authentication/security-tokens/live-sample-xsts-token.md)
- [Usar o Fiddler para inspecionar chamadas de serviços web](/pt-BR/tools/tools-services/live-fiddler-inspect-web-calls.md)
- [ResolveSubresourceRegion](/pt-BR/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist1/methods/id3d12graphicscommandlist1_resolvesubresourceregion_public.md)