WSK_BUF 구조체(wsk.h)

아티클
08/08/2023

WSK_BUF 구조는 소켓을 통해 데이터를 보내고 받는 데 사용되는 데이터 버퍼를 정의합니다.

구문

typedef struct _WSK_BUF {
  PMDL   Mdl;
  ULONG  Offset;
  SIZE_T Length;
} WSK_BUF, *PWSK_BUF;

멤버

Mdl

MDL(메모리 설명자 목록)에 대한 포인터입니다. MDL은 단일 MDL 또는 MDL 체인의 첫 번째 MDL일 수 있습니다. Length 멤버가 0이면 이 포인터는 NULL일 수 있습니다.

Offset

MDL에서 데이터가 시작되는 위치의 오프셋입니다. Mdl 멤버가 MDL 체인의 첫 번째 MDL을 가리키는 경우 이 오프셋은 체인의 첫 번째 MDL에서 설명하는 메모리 버퍼 내에 있어야 합니다. Mdl 멤버가 NULL이면 Offset 멤버가 사용되지 않습니다.

Length

WSK_BUF 구조체를 사용하여 소켓을 통해 보낼 데이터 버퍼를 설명하는 경우 이 멤버는 보낼 MDL(또는 MDL 체인)의 데이터 바이트 수를 지정합니다.

WSK_BUF 구조를 사용하여 소켓에서 데이터를 수신하는 버퍼를 설명하는 경우 이 멤버는 MDL(또는 MDL 체인)에 수신할 최대 바이트 수를 지정합니다.

WSK_BUF 구조체가 WSK_DATA_INDICATION 구조체 또는 WSK_DATAGRAM_INDICATION 구조체 내에 포함된 경우 이 멤버는 MDL(또는 MDL 체인)에서 받은 데이터의 바이트 수를 지정합니다.

설명

Mdl 멤버가 가리키는 MDL 체인의 각 MDL 은 잠겨 있거나 페이징되지 않은 풀에서 메모리를 설명합니다.

WSK 애플리케이션이 WSK_BUF 구조체에 대한 포인터를 WskReceive 함수에 전달하는 경우 애플리케이션은 구조체의 Length 멤버에 대해 0을 지정할 수 있습니다. 이 경우 데이터가 버퍼에 복사되지 않으므로 Mdl 멤버는 NULL 일 수 있습니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista 이상 버전의 Windows 운영 체제에서 사용할 수 있습니다.
머리글	wsk.h(Wsk.h 포함)