Método ID3D11InfoQueue::GetMessage (d3d11sdklayers.h)

  • Artículo

Obtiene un mensaje de la cola de mensajes.

Sintaxis

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

Parámetros

[in] MessageIndex

Tipo: UINT64

Indexe en la cola de mensajes después de aplicar un filtro de recuperación opcional. Puede estar comprendido entre 0 y el número de mensajes de la cola de mensajes que pasan por el filtro de recuperación (que se puede obtener con ID3D11InfoQueue::GetNumStoredMessagesAllowedByRetrievalFilter). 0 es el mensaje situado delante de la cola de mensajes.

[out, optional] pMessage

Tipo: D3D11_MESSAGE*

Mensaje devuelto (consulte D3D11_MESSAGE).

[in, out] pMessageByteLength

Tipo: SIZE_T*

Tamaño de pMessage en bytes, incluido el tamaño de la cadena de mensaje a la que apunta pMessage.

Valor devuelto

Tipo: HRESULT

Este método devuelve uno de los siguientes códigos de retorno de Direct3D 11.

Comentarios

Este método no quita ningún mensaje de la cola de mensajes.

Este método obtiene mensajes de la cola de mensajes después de aplicar un filtro de recuperación opcional.

Las aplicaciones deben llamar a este método dos veces para recuperar un mensaje: primero para obtener el tamaño del mensaje y el segundo para obtener el mensaje. Este es un ejemplo 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
D3D11_MESSAGE * pMessage = (D3D11_MESSAGE*)malloc(messageLength);
hr = pInfoQueue->GetMessage(0, pMessage, &messageLength);

Para obtener información general, consulte Información general sobre la cola de información.

Requisitos

Requisito Value
Plataforma de destino Windows
Encabezado d3d11sdklayers.h
Library D3D11.lib

Consulte también

Interfaz ID3D11InfoQueue