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)

另請參閱

WSK_SOCKET

WSK_BUF_LIST

CMSGHDR

搭配 Winsock 核心函式使用 IRP