> ## 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 (XBOX Series 主機)

> 從訊息佇列取得訊息。

從訊息佇列取得訊息。

## 語法

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

### 參數

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

取得訊息之實體的識別碼。

*MessageIndex*   \_In\_\
類型：UINT64

套用選擇性擷取篩選之後，訊息佇列中的索引。此值可以介於 0 和訊息佇列中通過擷取篩選的訊息數目之間。呼叫 [IDXGIInfoQueue::GetNumStoredMessagesAllowedByRetrievalFilters](/zh-TW/reference/graphics/d3d12_xs/interfaces/IDXGIInfoQueue/methods/idxgiinfoqueue_getnumstoredmessagesallowedbyretrievalfilters) 以取得此數目。0 是位於訊息佇列開頭的訊息。

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

指向描述訊息之 `DXGI_INFO_QUEUE_MESSAGE` 結構的指標。

*pMessageByteLength*   \_Inout\_\
類型：SIZE\_T\*

指向變數的指標，該變數會接收 *pMessage* 所指向之訊息描述的大小 (以位元組為單位)。此大小包含 `DXGI_INFO_QUEUE_MESSAGE` 結構的大小 (以位元組為單位)。

### 傳回值

類型：HRESULT

如果成功，則傳回 S\_OK；否則傳回錯誤碼。如需錯誤碼清單，請參閱 [Direct3D 12 傳回碼](https://learn.microsoft.com/en-us/windows/win32/direct3d12/d3d12-graphics-reference-returnvalues)。

## 需求

**標頭：** d3d12\_xs.h

**程式庫：** d3d12\_xs.lib\
**支援的平台：** XBOX Series 主機

## 另請參閱

[IDXGIInfoQueue](/zh-TW/reference/graphics/d3d12_xs/interfaces/IDXGIInfoQueue/idxgiinfoqueue)


## Related topics

- [NDA 主題目錄 - Microsoft Learn 線上連結](/zh-TW/nda/nda-topic-directory.md)
- [GetShaderIdentifier (XBOX Series 主機)](/zh-TW/reference/graphics/d3d12/interfaces/id3d12stateobjectproperties/methods/id3d12stateobjectproperties_getshaderidentifier_public.md)
- [GetPipelineStackSize (XBOX Series 主機)](/zh-TW/reference/graphics/d3d12/interfaces/id3d12stateobjectproperties/methods/id3d12stateobjectproperties_getpipelinestacksize_public.md)
- [GetShaderStackSize (XBOX Series 主機)](/zh-TW/reference/graphics/d3d12/interfaces/id3d12stateobjectproperties/methods/id3d12stateobjectproperties_getshaderstacksize_public.md)
- [GetResourceAllocationInfo1 (XBOX Series 主機)](/zh-TW/reference/graphics/d3d12/interfaces/id3d12device4/methods/id3d12device4_getresourceallocationinfo1_public.md)