ID3D10InfoQueue::GetMessage 메서드(d3d10sdklayers.h)
메시지 큐에서 메시지를 가져옵니다.
구문
HRESULT GetMessage(
[in] UINT64 MessageIndex,
[out] D3D10_MESSAGE *pMessage,
[in, out] SIZE_T *pMessageByteLength
);
매개 변수
[in] MessageIndex
형식: UINT64
선택적 검색 필터가 적용된 후 메시지 큐로 인덱싱합니다. 이는 검색 필터를 통과하는 메시지 큐의 메시지 수와 0 사이일 수 있습니다( ID3D10InfoQueue::GetNumStoredMessagesAllowedByRetrievalFilter를 사용하여 가져올 수 있음). 0은 메시지 큐의 맨 앞에 있는 메시지입니다.
[out] pMessage
형식: D3D10_MESSAGE*
반환된 메시지( D3D10_MESSAGE 참조).
[in, out] pMessageByteLength
형식: SIZE_T*
pMessage가 가리키는 메시지 문자열의 크기를 포함하여 pMessage의 크기(바이트)입니다.
반환 값
형식: HRESULT
이 메서드는 다음 Direct3D 10 반환 코드 중 하나를 반환합니다.
설명
이 메서드는 메시지 큐에서 메시지를 제거하지 않습니다.
이 메서드는 선택적 검색 필터가 적용된 후 메시지 큐에서 메시지를 가져옵니다.
애플리케이션은 메시지를 검색하기 위해 이 메서드를 두 번 호출해야 합니다. 먼저 메시지 크기를 가져오고 두 번째 메서드를 호출하여 메시지를 가져옵니다. 일반적인 예는 다음과 같습니다.
// 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);
개요는 정보 큐 개요를 참조하세요.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 대상 플랫폼 | Windows |
| 헤더 | d3d10sdklayers.h |