Fungsi FilterSendMessage (fltuser.h)
Fungsi FilterSendMessage mengirim pesan ke minifilter mode kernel.
Sintaks
HRESULT FilterSendMessage(
[in] HANDLE hPort,
[in, optional] LPVOID lpInBuffer,
[in] DWORD dwInBufferSize,
[out] LPVOID lpOutBuffer,
[in] DWORD dwOutBufferSize,
[out] LPDWORD lpBytesReturned
);
Parameter
[in] hPort
Handel port komunikasi dikembalikan oleh panggilan sebelumnya ke FilterConnectCommunicationPort. Parameter ini diperlukan dan tidak boleh NULL.
[in, optional] lpInBuffer
Penunjuk ke buffer yang dialokasikan penelepon yang berisi pesan yang akan dikirim ke minifilter. Format pesan ditentukan pemanggil. Parameter ini diperlukan dan tidak boleh NULL.
[in] dwInBufferSize
Ukuran, dalam byte, dari buffer yang diacu oleh lpInBuffer.
[out] lpOutBuffer
Pointer ke buffer yang dialokasikan penelepon yang menerima balasan (jika ada) dari minifilter.
[in] dwOutBufferSize
Ukuran, dalam byte, dari buffer yang ditujukkan oleh lpOutBuffer. Nilai ini diabaikan jika lpOutBufferADALAH NULL.
[out] lpBytesReturned
Penunjuk ke variabel yang dialokasikan pemanggil yang menerima jumlah byte yang dikembalikan dalam buffer yang dituju lpOutBuffer jika panggilan ke FilterSendMessage berhasil. Parameter ini diperlukan dan tidak boleh NULL.
Menampilkan nilai
FilterSendMessage mengembalikan S_OK jika berhasil. Jika tidak, ia mengembalikan nilai kesalahan.
Keterangan
Fungsi FilterSendMessage mengirim pesan ke minifilter. Pesan diteruskan ke rutinitas panggilan balik pemberitahuan pesan minifilter, yang memproses pesan. (Minifilter mendaftarkan rutinitas pemberitahuan panggilan balik pesannya dengan meneruskannya sebagai parameter MessageNotifyCallback ke FltCreateCommunicationPort.)
FilterSendMessage sinkron. Pemanggil dimasukkan ke dalam status tunggu hingga pesan dikirim dan balasan minifilter (jika ada) diterima.
Jika penelepon mengharapkan balasan, pemanggil harus meneruskan buffer non-NULL untuk parameter lpOutBuffer dan nilai positif untuk parameter dwOutBufferSize .
Untuk mendapatkan pesan dari minifilter, panggil FilterGetMessage.
Untuk membalas pesan dari minifilter, panggil FilterReplyMessage.
Minifilter mengirim pesan ke aplikasi mode pengguna dengan memanggil FltSendMessage.
Persyaratan
Target Platform | Universal |
Header | fltuser.h (termasuk Fltuser.h) |
Pustaka | FltLib.lib |
DLL | FltLib.dll |