ID3D10InfoQueue::GetMessage 方法 (d3d10sdklayers.h)

从消息队列获取消息。

语法

HRESULT GetMessage(
  [in]      UINT64        MessageIndex,
  [out]     D3D10_MESSAGE *pMessage,
  [in, out] SIZE_T        *pMessageByteLength
);

参数

[in] MessageIndex

类型: UINT64

应用可选检索筛选器后,索引到消息队列中。 这可以介于 0 和消息队列中通过检索筛选器的消息数 (可通过 ID3D10InfoQueue::GetNumStoredMessagesAllowedByRetrievalFilter) 获取。 0 是消息队列前面的消息。

[out] pMessage

类型: D3D10_MESSAGE*

返回的消息 (看到 D3D10_MESSAGE) 。

[in, out] pMessageByteLength

类型: SIZE_T*

pMessage 的大小(以字节为单位),包括 pMessage 指向的消息字符串的大小。

返回值

类型: HRESULT

此方法返回以下 Direct3D 10 返回代码之一。

注解

此方法不会从消息队列中删除任何消息。

此方法在应用可选检索筛选器后从消息队列中获取消息。

应用程序应调用此方法两次以检索消息 - 第一次是获取消息的大小,第二次是获取消息。 下面是一个典型示例:


// Get the size of the message
SIZE_T messageLength = 0;
HRESULT hr = pInfoQueue->GetMessage(0, NULL, &messageLength);

// Allocate space and get the message
D3D10_MESSAGE * pMessage = (D3D10_MESSAGE*)malloc(messageLength);
hr = pInfoQueue->GetMessage(0, pMessage, &messageLength);

有关概述,请参阅 信息队列概述

要求

要求
目标平台 Windows
标头 d3d10sdklayers.h

另请参阅

ID3D10InfoQueue 接口