PFN_WSK_SEND_MESSAGES回呼函式 (wsk.h)
WskSendMessages 函式會將多個數據報傳送至遠端傳輸位址。
語法
PFN_WSK_SEND_MESSAGES PfnWskSendMessages;
NTSTATUS PfnWskSendMessages(
[in] PWSK_SOCKET Socket,
[in] PWSK_BUF_LIST BufferList,
ULONG Flags,
[in, optional] PSOCKADDR RemoteAddress,
[in] ULONG ControlInfoLength,
[In_reads_bytes_opt] PCMSGHDR ControlInfo,
[in, out] PIRP Irp
)
{...}
參數
[in] Socket
WSK_SOCKET 結構的指標，指定要從中傳送數據報的套接字物件。
[in] BufferList
初始化 WSK_BUF_LIST 結構的指標，其中包含要傳送的數據報清單。
Flags
[保留]此參數保留供系統使用。 WSK 應用程式必須將此參數設定為 零。
[in, optional] RemoteAddress
結構的指標，指定要傳送數據報的遠端傳輸位址。
[in] ControlInfoLength
ControlInfo 參數所指向之緩衝區中的數據位元組數目。 如果沒有與數據報相關聯的控件資訊， ControlInfoLength 參數必須是 零。
[In_reads_bytes_opt] ControlInfo
緩衝區的指標，其中包含與所傳送之數據報相關聯的控件資訊。 控件信息數據是由一或多個控件數據物件所組成，每個物件都是以 CMSGHDR 結構開頭。 如果沒有與數據報相關聯的控制資訊，此參數應該是 NULL。
所有傳輸都可能不支援 ControlInfo。
[in, out] Irp
WSK 子系統用來異步完成傳送作業的呼叫端配置 IRP 指標。 如需搭配 WSK 函式使用 IRP 的詳細資訊，請參閱 搭配 Winsock 核心函式使用 IRP。
傳回值
| 傳回碼 | Description |
|---|---|
| STATUS_SUCCESS | 數據報已成功透過套接字傳送。 IRP 將會以成功狀態完成。 IRP 的 IoStatus.Information 字段包含已傳送的位元組數目。 |
| STATUS_PENDING | WSK 子系統無法立即透過套接字傳送數據報。 WSK 子系統會在 IRP 透過套接字傳送數據報之後完成。 傳送作業的狀態將會在 IRP 的 [IoStatus.Status ] 字段中傳回。 如果作業成功，IRP 的 IoStatus.Information 欄位將會包含已傳送的位元組數目。 |
| 其他狀態代碼 | 發生錯誤。 IRP 將會以失敗狀態完成。 |
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 8 |
| 標頭 | wsk.h (包含 wsk.h) |