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

# FindValue

> Procura uma entrada no cache cuja chave corresponda exatamente à chave fornecida.

Procura uma entrada no cache cuja chave corresponda exatamente à chave fornecida.

Chame a função duas vezes. A primeira vez para recuperar o tamanho do valor e a segunda vez para recuperar os dados. O armazenamento temporário em memória torna esse padrão de chamada eficiente.

## Sintaxe

```cpp theme={null}
HRESULT FindValue(
    const void  pKey,
    UINT KeySize,
    void  pValue,
    UINT  pValueSize
)
```

### Parâmetros

*pKey*\
Tipo: const void \*

A chave da entrada a ser procurada.

*KeySize*\
Tipo: UINT

O tamanho da chave, em bytes.

*pValue*\
Tipo: void \*

Um ponteiro para um bloco de memória que recebe a entrada armazenada em cache.

*pValueSize*\
Tipo: UINT \*

Um ponteiro para um **UINT** que recebe o tamanho da entrada armazenada em cache, em bytes.

### Valor retornado

Tipo: HRESULT

Se a função for bem-sucedida, ela retornará **S\_OK**. Caso contrário, retornará um [**HRESULT**](https://learn.microsoft.com/en-us/windows/desktop/com/structure-of-com-error-codes) [código de erro](https://learn.microsoft.com/en-us/windows/win32/com/com-error-codes-10).

| Valor retornado | Descrição |
| - | - |
| DXGI\_ERROR\_CACHE\_HASH\_COLLISION | Existe uma entrada com o mesmo hash da chave fornecida, mas a chave não corresponde exatamente. |
| DXGI\_ERROR\_NOT\_FOUND | A entrada não está presente. |

## Comentários

## Requisitos

**Cabeçalho:** d3d12\_xs.h ou d3d12\_x.h\
**Biblioteca:** d3d12\_xs.lib ou d3d12\_x.lib\
**Plataformas com suporte**: consoles XBOX Series e família XBOX One

## Confira também

* [APIs de cache de sombreadores do D3D12](https://microsoft.github.io/DirectX-Specs/d3d/ShaderCache.html)


## Related topics

- [IGameInput::FindDeviceFromId](/pt-BR/reference/input/gameinput/interfaces/igameinput/methods/igameinput_finddevicefromid.md)
- [Find Lobbies](/api-reference/lobby/find-lobbies.md)
- [IGameInput::FindDeviceFromObject](/pt-BR/reference/input/gameinput/deprecated/interfaces/igameinput/methods/igameinput_finddevicefromobject.md)
- [IGameInput::FindDeviceFromPlatformString](/pt-BR/reference/input/gameinput/interfaces/igameinput/methods/igameinput_finddevicefromplatformstring.md)
- [IGameInput::FindDeviceFromPlatformHandle](/pt-BR/reference/input/gameinput/deprecated/interfaces/igameinput/methods/igameinput_finddevicefromplatformhandle.md)