Metodo ID3D10InfoQueue::GetMessage (d3d10sdklayers.h)

Ottenere un messaggio dalla coda dei messaggi.

Sintassi

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

Parametri

[in] MessageIndex

Tipo: UINT64

Indicizzare in coda messaggi dopo l'applicazione di un filtro di recupero facoltativo. Può essere compreso tra 0 e il numero di messaggi nella coda di messaggi che passano attraverso il filtro di recupero (che può essere ottenuto con ID3D10InfoQueue::GetNumStoredMessagesAllowedByRetrievalFilter). 0 è il messaggio all'inizio della coda dei messaggi.

[out] pMessage

Tipo: D3D10_MESSAGE*

Messaggio restituito (vedere D3D10_MESSAGE).

[in, out] pMessageByteLength

Tipo: SIZE_T*

Dimensioni di pMessage in byte, incluse le dimensioni della stringa di messaggio a cui punta pMessage.

Valore restituito

Tipo: HRESULT

Questo metodo restituisce uno dei codici restituiti Direct3D 10 seguenti.

Commenti

Questo metodo non rimuove alcun messaggio dalla coda dei messaggi.

Questo metodo recupera i messaggi dalla coda di messaggi dopo l'applicazione di un filtro di recupero facoltativo.

Le applicazioni devono chiamare questo metodo due volte per recuperare un messaggio, in primo luogo per ottenere le dimensioni del messaggio e il secondo per ottenere il messaggio. Ecco un esempio tipico:

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

Per una panoramica, vedere Panoramica della coda di informazioni.

Requisiti

Requisito	Valore
Piattaforma di destinazione	Windows
Intestazione	d3d10sdklayers.h

Vedi anche

Interfaccia ID3D10InfoQueue