Funções SPI do Windows Sockets não são necessárias para SANs

Esta seção descreve as funções do SPI do Windows Sockets que um provedor de serviços SAN não precisa implementar. Essas funções são definidas em Ws2spi.h.

WSPAddressToString
A opção Windows Sockets usa o provedor TCP/IP para converter todos os componentes de uma estrutura SOCKADDR em uma cadeia de caracteres numérica legível por humanos que representa o endereço IP de um soquete.

Wspasyncselect
A opção Windows Sockets usa seu protocolo de sessão internamente para lidar com a notificação de eventos de rede para um soquete, se necessário.

WSPCancelBlockingCall
A opção Windows Sockets manipula internamente o cancelamento de solicitações de bloqueio que estão em andamento. Portanto, ele nunca emite o cancelamento de chamadas de bloqueio para uma DLL do provedor de serviços SAN. O comutador do Windows Sockets pode:

Cancele uma solicitação de conexão pendente fechando o soquete SAN. A DLL do provedor de serviços SAN deve anular a solicitação de conexão.

Cancele solicitações pendentes de envio e recebimento descartando dados para essas solicitações se a opção buffers de dados internamente ou aguardando que essas solicitações sejam concluídas se forem transferências rdma de ou para buffers de aplicativo. Para transferências de RDMA longas, a opção pode fechar a conexão completamente.

A documentação spi do Windows Sockets no SDK do Microsoft Windows avisa que, se uma chamada de bloqueio for cancelada, um aplicativo não poderá contar com uma conexão sendo preservada. Nesse caso, a única chamada com garantia de êxito no soquete após o cancelamento de uma solicitação de bloqueio é WSPCloseSocket.

WSPGetPeerName A opção Windows Sockets armazena em cache o endereço IP de um par quando a opção estabelece uma conexão com o par em uma chamada WSPConnect ou aceita uma conexão com o par em uma chamada WSPAccept . A opção fornece esse valor armazenado em cache para aplicativos, se necessário.

WSPGetSockName A opção Windows Sockets armazena em cache o endereço IP local de um soquete quando a opção associa o endereço ao soquete em uma chamada WSPBind ou aceita uma conexão com um par em uma chamada WSPAccept . A opção fornece esse valor armazenado em cache para aplicativos, se necessário.

Wspjoinleaf A opção Windows Sockets usa exclusivamente o provedor TCP/IP para lidar com sessões de vários pontos.

WSPRecvDisconnect A opção Windows Sockets manipula internamente o encerramento da recepção de dados em um soquete e recupera todos os dados de desconexão de entrada da parte remota.

Wsprecvfrom A versão atual do Windows Sockets Direct não dá suporte a provedores de serviços SAN que lidam com soquetes que recebem datagramas com semântica UDP (User Datagram Protocol). Portanto, a opção Windows Sockets chama a função WSPRecv de um provedor de serviços SAN em um soquete conectado para receber dados de fluxo com semântica TCP (Protocolo de Controle de Transmissão).

Wspselect A opção Windows Sockets usa seu protocolo de sessão internamente em cooperação com o provedor TCP/IP para determinar o status de soquetes, se necessário.

WSPSendDisconnect A opção Windows Sockets manipula internamente o encerramento da conexão de um soquete e envia dados de desconexão para a parte remota.

Wspsendto A versão atual do Windows Sockets Direct não dá suporte a provedores de serviços SAN que lidam com soquetes que enviam datagramas com semântica UDP (User Datagram Protocol). Portanto, a opção Windows Sockets chama a função WSPSend de um provedor de serviços SAN em um soquete conectado para enviar dados de fluxo com semântica do Protocolo de Controle de Transmissão (TCP).

Wspshutdown A opção Windows Sockets desabilita internamente a recepção e a transmissão de dados em um soquete.

Wspstartup A opção Windows Sockets não chama WSPStartup para iniciar a operação de um provedor de serviços SAN. Em vez disso, a opção usa a função WSPStatupEx do provedor de serviços SAN.

Wspstringtoaddress A opção Windows Sockets usa o provedor TCP/IP para converter uma cadeia de caracteres numérica legível por humanos que representa o endereço IP de um soquete em uma estrutura de endereço de soquete (SOCKADDR) adequada para passar para rotinas do Windows Sockets que usam essa estrutura.