Fungsi FilterConnectCommunicationPort (fltuser.h)

Artikel
08/23/2023

FilterConnectCommunicationPort membuka koneksi baru ke port server komunikasi yang dibuat oleh minifilter sistem file.

Sintaks

HRESULT FilterConnectCommunicationPort(
  [in]           LPCWSTR               lpPortName,
  [in]           DWORD                 dwOptions,
  [in, optional] LPCVOID               lpContext,
  [in]           WORD                  wSizeOfContext,
  [in, optional] LPSECURITY_ATTRIBUTES lpSecurityAttributes,
  [out]          HANDLE                *hPort
);

Parameter

[in] lpPortName

Penunjuk ke string karakter lebar yang dihentikan NULL yang berisi nama port server komunikasi yang sepenuhnya memenuhi syarat (misalnya, L"\MyFilterPort").

[in] dwOptions

Opsi koneksi untuk port komunikasi. Sebelum Windows 8.1, nilai ini diatur ke 0.

Nilai	Makna
FLT_PORT_FLAG_SYNC_HANDLE	Handel yang dikembalikan di hPort adalah untuk I/O sinkron. Bendera ini tersedia dimulai dengan Windows 8.1.

[in, optional] lpContext

Arahkan ke informasi konteks yang disediakan penelepon untuk diteruskan ke rutinitas pemberitahuan sambungkan minifilter mode kernel. (Lihat parameter ConnectNotifyCallback di halaman referensi untuk FltCreateCommunicationPort.) Parameter ini bersifat opsional dan dapat berupa NULL.

[in] wSizeOfContext

Ukuran, dalam byte, dari struktur yang dituju parameter lpContext . Jika nilai lpContext bukan NULL, parameter ini harus bukan nol. Jika lpContext adalah NULL, parameter ini harus nol.

[in, optional] lpSecurityAttributes

Penunjuk ke struktur SECURITY_ATTRIBUTES yang menentukan apakah handel yang dikembalikan dapat diwariskan oleh proses anak. Untuk informasi selengkapnya tentang struktur SECURITY_ATTRIBUTES, lihat dokumentasi Microsoft Windows SDK. Parameter ini bersifat opsional dan dapat berupa NULL. Jika parameter ini NULL, handel tidak dapat diwariskan.

[out] hPort

Penunjuk ke variabel yang dialokasikan penelepon yang menerima handel untuk port koneksi yang baru dibuat jika panggilan ke FilterConnectCommunicationPort berhasil; jika tidak, ia menerima INVALID_HANDLE_VALUE.

Mengembalikan nilai

FilterConnectCommunicationPort mengembalikan S_OK jika berhasil. Jika tidak, ia mengembalikan nilai kesalahan.

Keterangan

FilterConnectCommunicationPort membuka koneksi ke port server komunikasi minifilter atas nama aplikasi mode pengguna. Aplikasi ini menggunakan handel port koneksi yang dihasilkan untuk berkomunikasi dengan minifilter.

Setelah berhasil memanggil FilterConnectCommunicationPort, aplikasi dapat mengirim pesan ke minifilter melalui port koneksi dengan memanggil FilterSendMessage. Ini juga dapat menerima dan membalas pesan dari minifilter dengan memanggil FilterGetMessage dan FilterReplyMessage, masing-masing. Handel port koneksi yang dikembalikan dalam parameter hPort diteruskan sebagai parameter pertama ke FilterSendMessage, FilterGetMessage, dan FilterReplyMessage.

Setiap handel yang diperoleh dari FilterConnectCommunicationPort akhirnya harus dirilis dengan memanggil CloseHandle.