Windows Sockets SPI-functies niet vereist voor SAN's

In deze sectie worden de functies van de Windows Sockets SPI beschreven die een SAN-serviceprovider niet hoeft te implementeren. Deze functies worden gedefinieerd in Ws2spi.h.

WSPAddressToString
De Windows Sockets-switch maakt gebruik van de TCP/IP-provider om alle onderdelen van een SOCKADDR-structuur te converteren naar een door mensen leesbare numerieke tekenreeks die het IP-adres van een socket vertegenwoordigt.

WSPAsyncSelect
De Windows Sockets-switch maakt intern gebruik van het sessieprotocol voor het afhandelen van meldingen van netwerk gebeurtenissen voor een socket, indien nodig.

WSPCancelBlockingCall
De Windows Sockets-switch verwerkt intern de annulering van blokkeringsaanvragen die worden uitgevoerd. Daarom worden er nooit annuleringen van blokkerende oproepen naar een DLL van een SAN-serviceprovider uitgevoerd. De Windows Sockets-switch kan het volgende doen:

Annuleer een openstaande verbindingsaanvraag door de SAN-socket te sluiten. De DLL van de SAN-serviceprovider moet de verbindingsaanvraag afbreken.

Annuleer openstaande verzend- en ontvangstaanvragen door gegevens voor deze aanvragen te negeren als de switch die gegevens intern buffert of door te wachten tot deze aanvragen zijn voltooid als ze RDMA-overdrachten naar of van toepassingsbuffers zijn. Voor langdurige RDMA-overdrachten kan de switch de verbinding helemaal sluiten.

De Windows Sockets SPI-documentatie in de Microsoft Windows SDK waarschuwt dat als een blokkeringsaanroep wordt geannuleerd, een toepassing niet kan vertrouwen op een verbinding die behouden blijft. In dit geval is de enige aanroep die gegarandeerd succesvol is op de socket na de annulatie van een blokkeringsverzoek WSPCloseSocket.

WSPGetPeerName De Windows Sockets-switch slaat het IP-adres van een peer op wanneer de switch een verbinding met de peer tot stand brengt in een WSPConnect-aanroep of een verbinding met de peer accepteert in een WSPAccept-aanroep. De switch biedt deze waarde in de cache aan toepassingen, indien nodig.

WSPGetSockName De Windows Sockets-switch slaat het lokale IP-adres voor een socket op wanneer de switch het adres koppelt aan de socket in een WSPBind--aanroep of een verbinding met een peer accepteert in een WSPAccept aanroep. De switch biedt deze waarde in de cache aan toepassingen, indien nodig.

WSPJoinLeaf De Windows Sockets-switch maakt uitsluitend gebruik van de TCP/IP-provider voor het afhandelen van multipoint-sessies.

WSPRecvDisconnect De Windows Sockets-switch verwerkt intern de beëindiging van de gegevensontvangst op een socket en haalt alle binnenkomende ontkoppelingsgegevens van de externe partij op.

WSPRecvFrom De huidige versie van Windows Sockets Direct biedt geen ondersteuning voor SAN-serviceproviders die sockets verwerken die datagrammen ontvangen met UDP-semantiek (User Datagram Protocol). Daarom roept de Windows Sockets-switch de WSPRecv--functie van een SAN-serviceprovider aan op een verbonden socket om streamgegevens te ontvangen met TCP-semantiek (Transmission Control Protocol).

WSPSelect De Windows Sockets-switch maakt intern gebruik van het sessieprotocol in samenwerking met de TCP/IP-provider om de status van sockets te bepalen, indien nodig.

WSPSendDisconnect De Windows Sockets-switch verwerkt intern beëindiging van de verbinding voor een socket en verzendt verbindingsgegevens naar de externe partij.

WSPSendTo De huidige versie van Windows Sockets Direct biedt geen ondersteuning voor SAN-serviceproviders die sockets verwerken die datagrammen verzenden met UDP-semantiek (User Datagram Protocol). Daarom roept de Windows Sockets-switch de WSPSend--functie van een SAN-serviceprovider aan op een verbonden socket om streamgegevens te verzenden met TCP-semantiek (Transmission Control Protocol).

WSPShutdown De Windows Sockets-switch schakelt de ontvangst en overdracht van gegevens op een socket intern uit.

WSPStartup De Windows Sockets-switch roept geen WSPStartup- aan om de bewerking van een SAN-serviceprovider te starten. De switch maakt in plaats daarvan gebruik van de WSPStatupEx--functie van de SAN-serviceprovider.

WSPStringToAddress De Windows Sockets-switch gebruikt de TCP/IP-provider om een door mensen leesbare numerieke tekenreeks te converteren die het IP-adres van een socket vertegenwoordigt in een socketadresstructuur (SOCKADDR) die geschikt is om door te geven aan Windows Sockets-routines die een dergelijke structuur aannemen.