estrutura WSK_PROVIDER_CHARACTERISTICS (wsk.h)

A estrutura WSK_PROVIDER_CHARACTERISTICS especifica as características do subsistema WSK.

Sintaxe

typedef struct _WSK_PROVIDER_CHARACTERISTICS {
  USHORT HighestVersion;
  USHORT LowestVersion;
} WSK_PROVIDER_CHARACTERISTICS, *PWSK_PROVIDER_CHARACTERISTICS;

Membros

HighestVersion

A versão mais alta da NPI (Interface de Programação de Rede) do WSK que é compatível com o subsistema WSK.

LowestVersion

A versão mais baixa do NPI do WSK que é compatível com o subsistema WSK.

Comentários

Quando uma chamada WskCaptureProviderNPI falha com status código STATUS_NOINTERFACE, o aplicativo WSK pode usar uma chamada para WskQueryProviderCharacteristics para consultar o intervalo de versões de NPI do WSK compatíveis com o subsistema WSK. WskQueryProviderCharacteristics retorna as informações de versão por meio da estrutura WSK_PROVIDER_CHARACTERISTICS. Um aplicativo WSK pode usar essas informações para determinar se o subsistema WSK dá suporte a uma versão do WSK NPI compatível com o aplicativo.

Os números de versão principal e secundária contidos nos membros HighestVersion e LowerVersion são codificados usando a macro MAKE_WSK_VERSION:

Version = MAKE_WSK_VERSION(Major,Minor);

Os números de versão principal e secundária podem ser extraídos dos membros HighestVersion e LowerVersion usando as macros WSK_MAJOR_VERSION e WSK_MINOR_VERSION:

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

Se um aplicativo WSK determinar que o subsistema WSK dá suporte a uma versão do NPI do WSK compatível com o aplicativo, o aplicativo deverá chamar WskRegister e, por meio do membro Dispatch da estrutura WSK_CLIENT_NPI apontada pelo parâmetro WskClientNpi , ele deverá especificar a versão exata da NPI do WSK que gostaria de usar no membro Version da estrutura WSK_CLIENT_DISPATCH . O aplicativo WSK deve especificar os membros restantes da estrutura WSK_CLIENT_DISPATCH para estar em conformidade com a versão do NPI do WSK especificada no membro Version da estrutura.

Para obter mais informações sobre como anexar um aplicativo WSK ao subsistema WSK, consulte Registrando um aplicativo de kernel Winsock.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Disponível no Windows Vista e versões posteriores dos sistemas operacionais Windows.
Cabeçalho	wsk.h (inclua Wsk.h)

Confira também

WSK_CLIENT_DISPATCH

WSK_CLIENT_NPI

WskCaptureProviderNPI

WskQueryProviderCharacteristics

WskRegister