PFN_WSK_SOCKET 콜백 함수(wsk.h)

아티클
02/07/2025

WskSocket 함수는 새 소켓을 만들고 연결된 소켓 개체에 대한 포인터를 반환합니다.

통사론

PFN_WSK_SOCKET PfnWskSocket;

NTSTATUS PfnWskSocket(
  [in]           PWSK_CLIENT Client,
  [in]           ADDRESS_FAMILY AddressFamily,
  [in]           USHORT SocketType,
  [in]           ULONG Protocol,
  [in]           ULONG Flags,
  [in, optional] PVOID SocketContext,
  [in, optional] const VOID *Dispatch,
  [in, optional] PEPROCESS OwningProcess,
  [in, optional] PETHREAD OwningThread,
  [in, optional] PSECURITY_DESCRIPTOR SecurityDescriptor,
  [in, out]      PIRP Irp
)
{...}

매개 변수

[in] Client

의 WskProviderNpi 매개 변수를 통해 반환된 WSK_CLIENT 구조체에 대한 포인터입니다. WskCaptureProviderNPI 함수를.

[in] AddressFamily

생성되는 소켓의 주소 패밀리입니다. 지원되는 주소 패밀리에 대한 자세한 내용은 WSK 주소 패밀리 참조하세요.

[in] SocketType

생성되는 소켓의 형식입니다. 지원되는 소켓 유형은 다음과 같습니다.

SOCK_STREAM

신뢰할 수 있는 연결 지향 바이트 스트림 통신을 지원합니다.

SOCK_DGRAM

신뢰할 수 없는 연결 없는 데이터그램 통신을 지원합니다.

SOCK_RAW

전송 프로토콜에 대한 원시 액세스를 지원합니다.

지원되는 각 주소 패밀리에 대해 지원되는 소켓 유형에 대한 자세한 내용은 다음을 참조하세요.
WSK 주소 패밀리 .

[in] Protocol

생성되는 소켓에 대한 전송 프로토콜입니다. 지원되는 각 주소 패밀리에 대해 지원되는 프로토콜에 대한 자세한 내용은 WSK 주소 패밀리 참조하세요.

[in] Flags

생성되는 소켓에 대한 WSK 소켓 범주 지정하는 플래그입니다. 이 매개 변수는 다음 플래그 중 하나일 수 있습니다.

WSK_FLAG_BASIC_SOCKET

전송 스택 소켓 옵션을 가져와서 설정하거나 소켓 I/O 컨트롤 작업을 수행하는 데만 사용할 수 있는 기본 소켓이 만들어집니다.

WSK_FLAG_LISTEN_SOCKET

원격 전송 주소에서 들어오는 연결을 수신 대기하는 데 사용할 수 있는 수신 대기 소켓이 만들어집니다.

WSK_FLAG_DATAGRAM_SOCKET

데이터그램을 보내고 받는 데 사용할 수 있는 데이터그램 소켓이 만들어집니다.

WSK_FLAG_CONNECTION_SOCKET

연결을 통해 네트워크 데이터를 보내고 받는 데 사용할 수 있는 연결 지향 소켓이 만들어집니다.

WSK_FLAG_STREAM_SOCKET

원격 전송 주소에서 들어오는 연결을 수신 대기하거나 연결을 통해 네트워크 데이터를 보내고 받는 데 사용할 수 있는 스트림 소켓이 만들어집니다.

WSK 애플리케이션에서 이전 플래그를 지정하지 않으면 WskSocket 기본 소켓을 만듭니다.

[in, optional] SocketContext

생성되는 소켓에 대한 호출자 제공 컨텍스트에 대한 포인터입니다. WSK 하위 시스템은 이 포인터를 소켓의 이벤트 콜백 함수에 전달합니다. 컨텍스트 정보는 WSK 하위 시스템에 불투명하며 페이징되지 않은 메모리에 저장되어야 합니다. WSK 애플리케이션이 새 소켓에서 이벤트 콜백 함수를 사용하도록 설정하지 않는 경우 이 포인터를 NULL설정해야 합니다. 기본 소켓의 경우 이 포인터는 항상 NULL 합니다.

[in, optional] Dispatch

상수 클라이언트 디스패치 구조에 대한 포인터입니다. 이 구조는 새 소켓에 대한 이벤트 콜백 함수에 대한 포인터를 포함하는 디스패치 테이블입니다. 소켓의 WSK 소켓 범주 따라(Flags 매개 변수에 지정된 대로) 이 매개 변수는 다음 구조 중 하나에 대한 포인터입니다.

기	디스패치 테이블 구조
WSK_FLAG_LISTEN_SOCKET	WSK_CLIENT_LISTEN_DISPATCH
WSK_FLAG_DATAGRAM_SOCKET	WSK_CLIENT_DATAGRAM_DISPATCH
WSK_FLAG_CONNECTION_SOCKET	WSK_CLIENT_CONNECTION_DISPATCH
WSK_FLAG_STREAM_SOCKET	WSK_CLIENT_STREAM_DISPATCH

WSK 애플리케이션이 새 소켓에 대해 모든 이벤트 콜백 함수를 사용하도록 설정하지 않는 경우 디스패치 테이블의 포인터를 사용하지 않는 이벤트 콜백 함수에 대해 NULL 설정해야 합니다. WSK 애플리케이션이 새 소켓에서 이벤트 콜백 함수를 사용하도록 설정하지 않는 경우 Dispatch 포인터를 NULL설정해야 합니다. 기본 소켓의 경우 이 포인터는 항상 NULL 합니다.

[in, optional] OwningProcess

WSK 하위 시스템이 소켓을 바인딩할 때 사용할 보안 컨텍스트를 검색하는 프로세스에 대한 포인터입니다. WSK 하위 시스템은 보안 컨텍스트를 사용하여 해당 주소가 이미 사용 중인 경우 로컬 전송 주소를 공유할 수 있는지 여부를 결정합니다. 현재 프로세스를 지정하기 위해 WSK 애플리케이션은 이 포인터를 NULL설정합니다.

[in, optional] OwningThread

WSK 하위 시스템이 소켓을 바인딩할 때 사용할 보안 컨텍스트를 검색하는 특정 스레드에 대한 포인터입니다. WSK 하위 시스템은 보안 컨텍스트를 사용하여 해당 주소가 이미 사용 중인 경우 로컬 전송 주소를 공유할 수 있는지 여부를 결정합니다. WSK 애플리케이션이 특정 스레드를 지정할 필요가 없는 경우 이 포인터를 NULL설정합니다.

[in, optional] SecurityDescriptor

생성되는 소켓에 적용할 보안 설명자를 지정하는 SECURITY_DESCRIPTOR 구조체에 대한 포인터입니다. 보안 설명자는 소켓이 바인딩된 로컬 전송 주소의 공유를 제어합니다. WSK 애플리케이션이NULL 포인터를 지정하는 경우 WSK_CACHE_SD 제어 코드를 사용하여 WskControlClient 함수를 호출하여 가져온 보안 설명자의 캐시된 복사본에 대한 포인터를 지정해야 합니다. 로컬 전송 주소의 공유를 허용하지 않는 기본 보안 설명자를 지정하기 위해 WSK 애플리케이션은 SecurityDescriptor NULL 설정합니다.

SECURITY_DESCRIPTOR 구조에 대한 자세한 내용은 Microsoft Windows SDK 설명서의 SECURITY_DESCRIPTOR 참조 페이지를 참조하세요.

[in, out] Irp

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

반환 값

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

반환 코드	묘사
STATUS_SUCCESS	새 소켓이 성공적으로 만들어졌습니다. IRP는 성공 상태로 완료됩니다.
STATUS_PENDING	WSK 하위 시스템이 소켓을 즉시 만들 수 없습니다. WSK 하위 시스템은 새 소켓을 만든 후 IRP를 완료합니다. 소켓 생성 상태는 IRP의 IoStatus.Status 필드에 반환됩니다.
기타 상태 코드	오류가 발생했습니다. IRP는 실패 상태로 완료됩니다.

발언

IRP가 성공 상태로 완료되면 IRP의 IoStatus.Information 필드에 새 소켓에 대한 소켓 개체 구조(WSK_SOCKET)에 대한 포인터가 포함됩니다.

WSK 애플리케이션은 WSK_TRANSPORT_LIST_QUERY 제어 코드를 사용하여 WskControlClient 함수를 호출하여 사용 가능한 전송 프로토콜 목록을 가져올 수 있습니다. WskControlClientAddressFamily, SocketType및 Protocol 매개 변수의 유효한 조합이 모두 포함된 WSK_TRANSPORT 구조 목록을 반환합니다.

WSK 애플리케이션이 새 소켓을 성공적으로 만들면 새 소켓의 모든 이벤트 콜백 함수가 기본적으로 사용하지 않도록 설정됩니다. 새 소켓의 이벤트 콜백 함수를 사용하도록 설정하는 방법에 대한 자세한 내용은 이벤트 콜백 함수사용 및 비활성화를 참조하세요.

WSK 애플리케이션이 SecurityDescriptor 매개 변수에 대해NULL 포인터를 지정하는 경우 IRP가 완료될 때까지 캐시된 보안 설명자를 해제해서는 안 됩니다.

WSK 하위 시스템은 WSK 애플리케이션을 대신하여 새 소켓의 소켓 개체 구조(WSK_SOCKET)에 대한 메모리를 할당합니다. WSK 하위 시스템은 소켓이 닫혀 있을 때 이 메모리의 할당을 취소합니다.

요구 사항

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