Struktur WSACOMPLETION (winsock2.h)
Struktur WSACOMPLETION menentukan pengaturan pemberitahuan penyelesaian untuk panggilan kontrol I/O yang dilakukan ke namespace terdaftar.
Sintaks
typedef struct _WSACOMPLETION {
WSACOMPLETIONTYPE Type;
union {
struct {
HWND hWnd;
UINT uMsg;
WPARAM context;
} WindowMessage;
struct {
LPWSAOVERLAPPED lpOverlapped;
} Event;
struct {
LPWSAOVERLAPPED lpOverlapped;
LPWSAOVERLAPPED_COMPLETION_ROUTINE lpfnCompletionProc;
} Apc;
struct {
LPWSAOVERLAPPED lpOverlapped;
HANDLE hPort;
ULONG_PTR Key;
} Port;
} Parameters;
} WSACOMPLETION, *PWSACOMPLETION, *LPWSACOMPLETION;
Anggota
Type
Jenis: WSACOMPLETIONTYPE
Jenis pemberitahuan penyelesaian yang diperlukan. Lihat Keterangan.
Parameters
Parameter yang diperlukan untuk menyelesaikan panggilan balik. Struktur dalam serikat Parameter menentukan informasi yang diperlukan untuk menyelesaikan panggilan balik dari setiap jenis yang diberikan. Misalnya, struktur WindowMessage harus diisi saat Jenis diatur ke NSP_NOTIFY_HWND.
Parameters.WindowMessage
Parameters.WindowMessage.hWnd
Jenis: HWND Handel Windows.
Parameters.WindowMessage.uMsg
Jenis: UINT Handel pesan.
Parameters.WindowMessage.context
Jenis: WPARAM Konteks pesan atau handel.
Parameters.Event
Parameters.Event.lpOverlapped
Jenis: LPWSAOVERLAPPED Penunjuk ke struktur WSAOVERLAPPED .
Parameters.Apc
Parameters.Apc.lpOverlapped
Jenis: LPWSAOVERLAPPED Penunjuk ke struktur WSAOVERLAPPED .
Parameters.Apc.lpfnCompletionProc
Jenis: LPWSAOVERLAPPED_COMPLETION_ROUTINE _In_opt_
Penunjuk ke rutinitas penyelesaian yang disediakan aplikasi.
Parameters.Port
Parameters.Port.lpOverlapped
Jenis: LPWSAOVERLAPPED Penunjuk ke struktur WSAOVERLAPPED .
Parameters.Port.hPort
Jenis: HANDEL Handel ke port.
Parameters.Port.Key
Jenis: ULONG_PTR Penunjuk ke kunci.
Keterangan
Struktur WSACOMPLETION memungkinkan panggilan balik disediakan dalam salah satu format berikut, berdasarkan nilai yang disediakan dalam Jenis:
Format Panggilan Balik | Ketik nilai |
---|---|
Polling | NSP_NOTIFY_IMMEDIATELY |
Pesan Jendela | NSP_NOTIFY_HWND |
Kejadian | NSP_NOTIFY_EVENT |
APC | NSP_NOTIFY_APC |
Port Penyelesaian | NSP_NOTIFY_PORT |
Untuk fungsi pemblokiran, atur struktur WSACOMPLETION ke null.
Persyaratan
Klien minimum yang didukung | Windows XP [hanya aplikasi desktop] |
Server minimum yang didukung | Windows Server 2003 [hanya aplikasi desktop] |
Header | winsock2.h |