PFN_WSK_SEND_MESSAGES 콜백 함수(wsk.h)

아티클
08/08/2023

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 애플리케이션은 이 매개 변수를 0으로 설정해야 합니다.

[in, optional] RemoteAddress

데이터그램을 보낼 원격 전송 주소를 지정하는 구조체에 대한 포인터입니다.

[in] ControlInfoLength

ControlInfo 매개 변수가 가리키는 버퍼의 데이터 바이트 수입니다. 데이터그램과 연결된 컨트롤 정보가 없는 경우 ControlInfoLength 매개 변수는 0이어야 합니다.

[In_reads_bytes_opt] ControlInfo

전송되는 데이터그램과 연결된 제어 정보를 포함하는 버퍼에 대한 포인터입니다. 컨트롤 정보 데이터는 하나 이상의 컨트롤 데이터 개체로 구성되며, 각 개체는 CMSGHDR 구조로 시작합니다. 데이터그램과 연결된 컨트롤 정보가 없는 경우 이 매개 변수는 NULL이어야 합니다.

ControlInfo 는 모든 전송에서 지원되지 않을 수 있습니다.

[in, out] Irp

WSK 하위 시스템이 비동기적으로 보내기 작업을 완료하는 데 사용하는 호출자 할당 IRP에 대한 포인터입니다. WSK 함수에서 IRP를 사용하는 방법에 대한 자세한 내용은 Winsock 커널 함수에서 IRP 사용을 참조하세요.

반환 값

반환 코드	설명
STATUS_SUCCESS	데이터그램이 소켓을 통해 성공적으로 전송되었습니다. IRP는 성공 상태 완료됩니다. IRP의 IoStatus.Information 필드에는 전송된 바이트 수가 포함됩니다.
STATUS_PENDING	WSK 하위 시스템은 소켓을 통해 데이터그램을 즉시 보낼 수 없습니다. WSK 하위 시스템은 소켓을 통해 데이터그램을 보낸 후 IRP를 완료합니다. 보내기 작업의 상태 IRP의 IoStatus.Status 필드에 반환됩니다. 작업이 성공하면 IRP의 IoStatus.Information 필드에 전송된 바이트 수가 포함됩니다.
기타 상태 코드	오류가 발생했습니다. IRP는 실패 상태 완료됩니다.