PFN_WSK_SEND 콜백 함수(wsk.h)

아티클
08/08/2023

WskSend 함수는 연결 지향 또는 스트림 소켓을 통해 원격 전송 주소로 데이터를 보냅니다.

구문

PFN_WSK_SEND PfnWskSend;

NTSTATUS PfnWskSend(
  [in]      PWSK_SOCKET Socket,
  [in]      PWSK_BUF Buffer,
  [in]      ULONG Flags,
  [in, out] PIRP Irp
)
{...}

매개 변수

[in] Socket

데이터를 보낼 소켓의 소켓 개체를 지정하는 WSK_SOCKET 구조체에 대한 포인터입니다.

[in] Buffer

소켓을 통해 전송되는 데이터가 포함된 데이터 버퍼를 설명하는 초기화된 WSK_BUF 구조체에 대한 포인터입니다.

[in] Flags

다음 플래그 조합의 비트 OR을 포함하는 ULONG 값입니다.

WSK_FLAG_NODELAY

데이터와 이전에 큐에 대기한 데이터를 지연 없이 원격 애플리케이션으로 즉시 보내도록 기본 전송을 지시합니다.

이 플래그는 Microsoft TCP/IP 전송 프로토콜에서 지원됩니다. 이 플래그는 다른 전송 프로토콜에서 지원되지 않을 수 있습니다.

[in, out] Irp

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

반환 값

WskSend 는 다음 NTSTATUS 코드 중 하나를 반환합니다.

반환 코드	설명
STATUS_SUCCESS	소켓을 통해 데이터가 성공적으로 전송되었습니다. IRP는 성공 상태 완료됩니다. IRP의 IoStatus.Information 필드에는 전송된 바이트 수가 포함됩니다.
STATUS_PENDING	WSK 하위 시스템은 소켓을 통해 데이터를 즉시 보낼 수 없습니다. WSK 하위 시스템은 소켓을 통해 데이터를 보낸 후 IRP를 완료합니다. 보내기 작업의 상태 IRP의 IoStatus.Status 필드에 반환됩니다. 작업이 성공하면 IRP의 IoStatus.Information 필드에 전송된 바이트 수가 포함됩니다.
STATUS_FILE_FORCED_CLOSED	소켓이 더 이상 작동하지 않습니다. IRP는 실패 상태 완료됩니다. WSK 애플리케이션은 WskCloseSocket 함수를 호출하여 가능한 한 빨리 소켓을 닫아야 합니다.
STATUS_NOT_SUPPORTED	지정된 플래그는 기본 네트워크 전송에서 지원되지 않습니다.
기타 상태 코드	오류가 발생했습니다. IRP는 실패 상태 완료됩니다.

설명

WSK 애플리케이션은 이전에 원격 전송 주소에 연결된 연결 지향 또는 스트림 소켓에서만 WskSend 함수를 호출할 수 있습니다. 연결 지향 소켓은 다음 방법 중 하나로 원격 전송 주소에 연결됩니다.

WSK 애플리케이션은 WskConnect 함수를 호출하여 소켓을 연결합니다.
WSK 애플리케이션은 WskSocketConnect 함수를 호출하여 소켓을 만들고, 바인딩하고, 연결합니다.
WSK 하위 시스템은 WSK 애플리케이션이 수신 대기 소켓에서 들어오는 연결 요청을 수락할 때 소켓을 연결합니다.

WskSend 함수가 STATUS_PENDING 반환하는 경우 Buffer 매개 변수가 가리키는 WSK_BUF 구조에 설명된 MDL 체인은 IRP가 완료될 때까지 메모리에 잠겨 있어야 합니다.

WSK 하위 시스템은 소켓을 통해 데이터를 보낼 때 데이터의 버퍼링을 수행하지 않습니다. 따라서 WskSend 함수에 대한 호출은 모든 데이터가 실제로 전송될 때까지 WSK 하위 시스템에 의해 완료되지 않습니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista 이상 버전의 Windows 운영 체제에서 사용할 수 있습니다.
대상 플랫폼	유니버설
헤더	wsk.h(Wsk.h 포함)
IRQL	<= DISPATCH_LEVEL