Fungsi FilterSendMessage (fltuser.h)

Artikel
08/23/2023

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.