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

# GetMessage (consoles XBOX Series)

> Obtém uma mensagem da fila de mensagens.

Obtém uma mensagem da fila de mensagens.

## Sintaxe

```cpp theme={null}
HRESULT GetMessage(  
         DXGI_DEBUG_ID Producer,  
         UINT64 MessageIndex,  
         DXGI_INFO_QUEUE_MESSAGE* pMessage,  
         SIZE_T* pMessageByteLength  
)  
```

### Parâmetros

*Producer*   \_In\_\
Tipo: [DXGI\_DEBUG\_ID](https://learn.microsoft.com/en-us/windows/desktop/direct3ddxgi/dxgi-debug-id)

O identificador da entidade que obtém a mensagem.

*MessageIndex*   \_In\_\
Tipo: UINT64

Um índice na fila de mensagens após a aplicação de um filtro de recuperação opcional. Pode estar entre 0 e o número de mensagens na fila de mensagens que passam pelo filtro de recuperação. Chame [IDXGIInfoQueue::GetNumStoredMessagesAllowedByRetrievalFilters](/pt-BR/reference/graphics/d3d12_xs/interfaces/IDXGIInfoQueue/methods/idxgiinfoqueue_getnumstoredmessagesallowedbyretrievalfilters) para obter esse número. 0 é a mensagem no início da fila de mensagens.

*pMessage*   \_Out\_writes\_bytes\_opt\_(\*pMessageByteLength)\
Tipo: [DXGI\_INFO\_QUEUE\_MESSAGE](https://learn.microsoft.com/en-us/windows/desktop/api/dxgidebug/ns-dxgidebug-dxgi_info_queue_message)\*

Um ponteiro para uma estrutura `DXGI_INFO_QUEUE_MESSAGE` que descreve a mensagem.

*pMessageByteLength*   \_Inout\_\
Tipo: SIZE\_T\*

Um ponteiro para uma variável que recebe o tamanho, em bytes, da descrição da mensagem apontada por *pMessage*. Esse tamanho inclui o tamanho da estrutura `DXGI_INFO_QUEUE_MESSAGE` em bytes.

### Valor retornado

Tipo: HRESULT

Retornará S\_OK se for bem-sucedido; caso contrário, retornará um código de erro. Para obter uma lista de códigos de erro, consulte [Códigos de retorno do Direct3D 12](https://learn.microsoft.com/en-us/windows/win32/direct3d12/d3d12-graphics-reference-returnvalues).

## Requisitos

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

**Biblioteca:** d3d12\_xs.lib\
**Plataformas com suporte**: consoles XBOX Series

## Confira também

[IDXGIInfoQueue](/pt-BR/reference/graphics/d3d12_xs/interfaces/IDXGIInfoQueue/idxgiinfoqueue)


## Related topics

- [GetShaderIdentifier (XBOX Series consoles)](/reference/graphics/d3d12/interfaces/id3d12stateobjectproperties/methods/id3d12stateobjectproperties_getshaderidentifier_public.md)
- [GetPipelineStackSize (XBOX Series consoles)](/reference/graphics/d3d12/interfaces/id3d12stateobjectproperties/methods/id3d12stateobjectproperties_getpipelinestacksize_public.md)
- [GetShaderStackSize (XBOX Series consoles)](/reference/graphics/d3d12/interfaces/id3d12stateobjectproperties/methods/id3d12stateobjectproperties_getshaderstacksize_public.md)
- [GetResourceAllocationInfo1 (XBOX Series consoles)](/reference/graphics/d3d12/interfaces/id3d12device4/methods/id3d12device4_getresourceallocationinfo1_public.md)
- [D3D12GetInterface (XBOX Series consoles)](/reference/graphics/d3d12/functions/d3d12getinterface_public.md)