Método ID3D10InfoQueue::GetMessage (d3d10sdklayers.h)
Obtenga un mensaje de la cola de mensajes.
Sintaxis
HRESULT GetMessage(
[in] UINT64 MessageIndex,
[out] D3D10_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. Esto puede estar 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 ID3D10InfoQueue::GetNumStoredMessagesAllowedByRetrievalFilter). 0 es el mensaje situado delante de la cola de mensajes.
[out] pMessage
Tipo: D3D10_MESSAGE*
Mensaje devuelto (consulte D3D10_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 10.
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
D3D10_MESSAGE * pMessage = (D3D10_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 | d3d10sdklayers.h |