METODE ID3D11InfoQueue::GetMessage (d3d11sdklayers.h)
Dapatkan pesan dari antrean pesan.
Sintaks
HRESULT GetMessage(
[in] UINT64 MessageIndex,
[out, optional] D3D11_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 ID3D11InfoQueue::GetNumStoredMessagesAllowedByRetrievalFilter). 0 adalah pesan di bagian depan antrean pesan.
[out, optional] pMessage
Jenis: D3D11_MESSAGE*
Pesan yang dikembalikan (lihat D3D11_MESSAGE).
[in, out] pMessageByteLength
Jenis: SIZE_T*
Ukuran pMessage dalam byte, termasuk ukuran string pesan yang diarahkan pMessage.
Nilai kembali
Jenis: HRESULT
Metode ini mengembalikan salah satu Kode Pengembalian Direct3D 11 berikut.
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
D3D11_MESSAGE * pMessage = (D3D11_MESSAGE*)malloc(messageLength);
hr = pInfoQueue->GetMessage(0, pMessage, &messageLength);
Untuk gambaran umum, lihat Gambaran Umum Antrean Informasi.
Persyaratan
Persyaratan | Nilai |
---|---|
Target Platform | Windows |
Header | d3d11sdklayers.h |
Pustaka | D3D11.lib |