Método ID3D10InfoQueue::GetMessage (d3d10sdklayers.h)

Obtenha uma mensagem da fila de mensagens.

Sintaxe

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

Parâmetros

[in] MessageIndex

Tipo: UINT64

Indexe na fila de mensagens depois que um filtro de recuperação opcional tiver sido aplicado. Isso pode ser entre 0 e o número de mensagens na fila de mensagens que passam pelo filtro de recuperação (que pode ser obtido com ID3D10InfoQueue::GetNumStoredMessagesAllowedByRetrievalFilter). 0 é a mensagem na frente da fila de mensagens.

[out] pMessage

Tipo: D3D10_MESSAGE*

Mensagem retornada (consulte D3D10_MESSAGE).

[in, out] pMessageByteLength

Tipo: SIZE_T*

Tamanho de pMessage em bytes, incluindo o tamanho da cadeia de caracteres de mensagem para a qual o pMessage aponta.

Retornar valor

Tipo: HRESULT

Esse método retorna um dos seguintes códigos de retorno do Direct3D 10.

Comentários

Esse método não remove nenhuma mensagem da fila de mensagens.

Esse método obtém mensagens da fila de mensagens após a aplicação de um filtro de recuperação opcional.

Os aplicativos devem chamar esse método duas vezes para recuperar uma mensagem – primeiro para obter o tamanho da mensagem e o segundo para obter a mensagem. Aqui está um exemplo típico:

// 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);

Para obter uma visão geral, consulte Visão geral da fila de informações.

Requisitos

Confira também

ID3D10InfoQueue Interface