FindValue

Looks up an entry in the cache whose key exactly matches the provided key. Call the function twice. The first time to retrieve the value’s size, and the second time to retrieve the data. In-memory temporary storage makes this calling pattern performant.

Syntax

HRESULT FindValue(
    const void  pKey,
    UINT KeySize,
    void  pValue,
    UINT  pValueSize
)

Parameters

pKey
Type: const void * The key of the entry to look up. KeySize
Type: UINT The size of the key, in bytes. pValue
Type: void * A pointer to a memory block that receives the cached entry. pValueSize
Type: UINT * A pointer to a UINT that receives the size of the cached entry, in bytes.

Return value

Type: HRESULT If the function succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Return value	Description
DXGI_ERROR_CACHE_HASH_COLLISION	There’s an entry with the same hash as the provided key, but the key doesn’t exactly match.
DXGI_ERROR_NOT_FOUND	The entry isn’t present.

Remarks

Requirements

Header: d3d12_xs.h or d3d12_x.h
Library: d3d12_xs.lib or d3d12_x.lib
Supported Platforms: XBOX Series consoles and XBOX One family

(all) API references

Error codes

Audio API reference

Chat API reference

Developer kit only API reference

Graphics API reference

Input API reference

Lighting API reference

Networking API reference

XBOX PC remote iteration API reference

System API reference

Tools API reference

Windows device portal REST API reference

XBOX services API reference

MicrosoftGame.config reference

Syntax

Parameters

Return value

Remarks

Requirements

See Also

​Syntax

​Parameters

​Return value

​Remarks

​Requirements

​See Also

Syntax

Parameters

Return value

Remarks

Requirements

See Also