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 |