ID3D12InfoQueue::GetMessage method (d3d12sdklayers.h)

Dapatkan pesan dari antrean pesan.

Sintaks

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

Parameter

[in] MessageIndex

Jenis: UINT64

Indeks ke dalam antrean pesan setelah filter pengambilan opsional diterapkan. Ini bisa antara 0 dan jumlah pesan dalam antrean pesan yang melewati filter pengambilan (yang dapat diperoleh dengan GetNumStoredMessagesAllowedByRetrievalFilter). 0 adalah pesan di bagian depan antrean pesan.

[out, optional] pMessage

Jenis: D3D12_MESSAGE*

Pesan yang dikembalikan.

[in, out] pMessageByteLength

Jenis: SIZE_T*

Ukuran pMessage dalam byte.

Nilai kembali

Jenis: HRESULT

Metode ini mengembalikan salah satu Kode Pengembalian Direct3D 12.

Keterangan

Metode ini tidak menghapus pesan apa pun dari antrean pesan.

Metode ini mendapatkan pesan dari antrean pesan setelah filter pengambilan opsional diterapkan.

Aplikasi harus memanggil metode ini dua kali untuk mengambil pesan - pertama untuk mendapatkan ukuran pesan dan kedua untuk mendapatkan pesan. Berikut adalah contoh umumnya:

 
// Get the size of the message
SIZE_T messageLength = 0;
HRESULT hr = pInfoQueue->GetMessage(0, NULL, &messageLength);

// Allocate space and get the message
D3D12_MESSAGE * pMessage = (D3D12_MESSAGE*)malloc(messageLength);
hr = pInfoQueue->GetMessage(0, pMessage, &messageLength); 

Persyaratan

Target Platform	Windows
Header	d3d12sdklayers.h

Lihat juga

ID3D12InfoQueue