PFLT_CONNECT_NOTIFY fungsi panggilan balik (fltkernel.h)

Artikel
07/16/2024

FltMgr memanggil fungsi panggilan balik ConnectNotifyCallback minifilter untuk memberi tahu minifilter saat koneksi baru ke port komunikasi sedang diminta.

Sintaksis

PFLT_CONNECT_NOTIFY PfltConnectNotify;

NTSTATUS PfltConnectNotify(
  PFLT_PORT ClientPort,
  PVOID ServerPortCookie,
  PVOID ConnectionContext,
  ULONG SizeOfContext,
  PVOID *ConnectionPortCookie
)
{...}

Parameter

ClientPort

[di] Buram, FltMgr-menghasilkan handel untuk port klien baru yang sedang dibuat antara aplikasi mode pengguna dan minifilter mode kernel.

Minifilter harus meneruskan handel ini sebagai parameter ClientPort ke FltSendMessage saat mengirim dan membalas pesan pada port klien ini.

Minifilter akhirnya harus memanggil FltCloseClientPort untuk menutup port klien ini, biasanya dari rutinitas DisconnectNotifyCallback.

ClientPort tidak sama dengan ServerPort menangani pengembalian olehFltCreateCommunicationPort.

ServerPortCookie

[di] Penunjuk ke informasi konteks yang ditentukan oleh minifilter. Minifilter dapat menggunakan informasi ini untuk membedakan di antara beberapa port server komunikasi yang mungkin dibuat. Ketika port server dibuat, driver minifilter melewati penunjuk konteks ini sebagai parameter ServerPortCookie untuk FltCreateCommunicationPort.

ConnectionContext

[di] Penunjuk informasi konteks yang diteruskan aplikasi mode pengguna dalam parameter lpContext ke FilterConnectCommunicationPort.

SizeOfContext

[di] Ukuran, dalam byte, buffer yang ConnectionContext menunjuk.

ConnectionPortCookie

[out] Arahkan ke informasi miniport yang secara unik mengidentifikasi port klien ini. Minifilter dapat menggunakan cookie ini untuk mengidentifikasi koneksi ketika FltMgr meneruskannya dalam panggilan berikutnya ke MessageNotifyCallback dan DisconnectNotifyCallback.

Mengembalikan nilai

ConnectNotifyCallback mengembalikan STATUS_SUCCESS jika operasi berhasil dan koneksi telah diterima. Jika tidak, nilai NTSTATUS yang sesuai seperti:

Mengembalikan kode	Arti
STATUS_INSUFFICIENT_RESOURCES	Tidak ada cukup sumber daya untuk menyelesaikan operasi.
STATUS_INVALID_PARAMETER	Satu atau beberapa parameter input tidak valid.

Komentar

FltMgr memanggil rutinitas ini setiap kali aplikasi mode pengguna memanggil FilterConnectCommunicationPort untuk mengirim permintaan koneksi ke driver minifilter.

Minifilter harus melakukan validasi yang diperlukan dari upaya koneksi.

Untuk informasi selengkapnya, lihat Komunikasi antara mode pengguna dan minifilter.