WSK_PROVIDER_DISPATCH 구조체(wsk.h)

WSK_PROVIDER_DISPATCH 구조체는 특정 소켓과 관련이 없는 WSK 하위 시스템의 함수 디스패치 테이블을 지정합니다.

구문

typedef struct _WSK_PROVIDER_DISPATCH {
  USHORT                    Version;
  USHORT                    Reserved;
  PFN_WSK_SOCKET            WskSocket;
  PFN_WSK_SOCKET_CONNECT    WskSocketConnect;
  PFN_WSK_CONTROL_CLIENT    WskControlClient;
  PFN_WSK_GET_ADDRESS_INFO  WskGetAddressInfo;
  PFN_WSK_FREE_ADDRESS_INFO WskFreeAddressInfo;
  PFN_WSK_GET_NAME_INFO     WskGetNameInfo;
} WSK_PROVIDER_DISPATCH, *PWSK_PROVIDER_DISPATCH;

멤버

Version

WSK 하위 시스템이 WSK 애플리케이션에 첨부하는 데 사용할 WSK NPI(네트워크 프로그래밍 인터페이스) 버전입니다.

Reserved

시스템에서 사용하도록 예약되었습니다.

WskSocket

WSK 하위 시스템의 WskSocket 함수에 대한 포인터입니다.

WskSocketConnect

WSK 하위 시스템의 WskSocketConnect 함수에 대한 포인터입니다.

WskControlClient

WSK 하위 시스템의 WskControlClient 함수에 대한 포인터입니다.

WskGetAddressInfo

WSK 하위 시스템의 WskGetAddressInfo 함수에 대한 포인터입니다.

이 멤버는 Windows 7부터 사용할 수 있습니다.

WskFreeAddressInfo

WSK 하위 시스템의 WskFreeAddressInfo 함수에 대한 포인터입니다.

이 멤버는 Windows 7부터 사용할 수 있습니다.

WskGetNameInfo

WSK 하위 시스템의 WskGetNameInfo 함수에 대한 포인터입니다.

이 멤버는 Windows 7부터 사용할 수 있습니다.

설명

WSK 애플리케이션이 WskCaptureProviderNPI 함수를 호출하면 WSK 하위 시스템은 WskProviderNpi 매개 변수가 가리키는 WSK_CLIENT_NPI 구조체의 Dispatch 멤버를 통해 WSK_PROVIDER_DISPATCH 구조체에 대한 포인터를 반환합니다.

Version 멤버에 포함된 주 버전 및 부 버전 번호는 MAKE_WSK_VERSION 매크로를 사용하여 인코딩됩니다.

Version = MAKE_WSK_VERSION(Major,Minor);

WSK_MAJOR_VERSION 및 WSK_MINOR_VERSION 매크로를 사용하여 Version 멤버에서 주 버전 및 부 버전 번호를 추출할 수 있습니다.

Major = WSK_MAJOR_VERSION(Version);
Minor = WSK_MINOR_VERSION(Version);

이 구조체의 Version 멤버 내에 포함된 부 버전 번호는 WSK_CLIENT_DISPATCH 구조체의 Version 멤버에서 WSK 애플리케이션에서 요청한 것보다 더 높은 부 버전 번호일 수 있습니다. WSK NPI의 상위 부 버전이 동일한 주 버전 번호가 있는 경우 WSK NPI 하위 버전의 엄격한 상위 집합이므로 WSK 애플리케이션에 문제가 발생하지 않아야 합니다. WSK 하위 시스템은 구조체의 Version 멤버에 표시된 WSK NPI 버전을 준수하도록 WSK_PROVIDER_DISPATCH 구조체의 나머지 멤버를 지정합니다.

WSK 하위 시스템에 WSK 애플리케이션을 연결하는 방법에 대한 자세한 내용은 Winsock 커널 애플리케이션 등록을 참조하세요.

요구 사항

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

추가 정보

WSK_CLIENT_DISPATCH

WSK_CLIENT_NPI

WskCaptureProviderNPI

WskControlClient

WskSocket

WskSocketConnect