Fonctions SPI des sockets Windows non requises pour les SAN

Cette section décrit les fonctions du SPI Windows Sockets qu’un fournisseur de services SAN n’est pas nécessaire d’implémenter. Ces fonctions sont définies dans Ws2spi.h.

WSPAddressToString
Le commutateur Windows Sockets utilise le fournisseur TCP/IP pour convertir tous les composants d’une structure SOCKADDR en chaîne numérique lisible par l’homme qui représente l’adresse IP d’un socket.

WSPAsyncSelect
Le commutateur Windows Sockets utilise son protocole de session en interne pour gérer la notification des événements réseau pour un socket, si nécessaire.

WSPCancelBlockingCall
Le commutateur Windows Sockets gère en interne l’annulation des demandes bloquantes en cours. Par conséquent, il n’annule jamais les appels bloquants à une DLL de fournisseur de services SAN. Le commutateur Windows Sockets peut :

Annulez une demande de connexion en attente en fermant le socket SAN. La DLL du fournisseur de services SAN doit abandonner la demande de connexion.

Annulez les demandes d’envoi et de réception en attente en ignorant les données pour ces demandes si le commutateur met en mémoire tampon ces données en interne, ou en attendant que ces demandes se terminent si elles sont transférées rdma vers ou depuis des mémoires tampons d’application. Pour les transferts RDMA longs, le commutateur peut fermer complètement la connexion.

La documentation SPI windows sockets dans le Microsoft Windows SDK avertit que si un appel bloquant est annulé, une application ne peut pas compter sur une connexion conservée. Dans ce cas, le seul appel qui est garanti pour réussir sur le socket après l’annulation d’une demande bloquante est WSPCloseSocket.

WSPGetPeerName Le commutateur Windows Sockets met en cache l’adresse IP d’un homologue lorsque le commutateur établit une connexion à l’homologue dans un appel WSPConnect ou accepte une connexion à l’homologue dans un appel WSPAccept . Le commutateur fournit cette valeur mise en cache aux applications, si nécessaire.

WSPGetSockName Le commutateur Windows Sockets met en cache l’adresse IP locale d’un socket lorsque le commutateur associe l’adresse au socket dans un appel WSPBind ou accepte une connexion à un homologue dans un appel WSPAccept . Le commutateur fournit cette valeur mise en cache aux applications, si nécessaire.

WSPJoinLeaf Le commutateur Windows Sockets utilise exclusivement le fournisseur TCP/IP pour gérer les sessions multipoint.

WSPRecvDisconnect Le commutateur Windows Sockets gère en interne l’arrêt de la réception des données sur un socket et récupère toutes les données de déconnexion entrantes de la partie distante.

WSPRecvFrom La version actuelle de Windows Sockets Direct ne prend pas en charge les fournisseurs de services SAN qui gèrent les sockets qui reçoivent des datagrammes avec la sémantique UDP (User Datagram Protocol). Par conséquent, le commutateur Windows Sockets appelle la fonction WSPRecv d’un fournisseur de services SAN sur un socket connecté pour recevoir des données de flux avec la sémantique TCP (Transmission Control Protocol).

WSPSelect Le commutateur Windows Sockets utilise son protocole de session en interne en coopération avec le fournisseur TCP/IP pour déterminer la status des sockets, si nécessaire.

WSPSendDisconnect Le commutateur Windows Sockets gère en interne l’arrêt de la connexion pour un socket et envoie les données de déconnexion à la partie distante.

WSPSendTo La version actuelle de Windows Sockets Direct ne prend pas en charge les fournisseurs de services SAN qui gèrent les sockets qui envoient des datagrammes avec la sémantique UDP (User Datagram Protocol). Par conséquent, le commutateur Windows Sockets appelle la fonction WSPSend d’un fournisseur de services SAN sur un socket connecté pour envoyer des données de flux avec la sémantique TCP (Transmission Control Protocol).

WSPShutdown Le commutateur Windows Sockets désactive en interne la réception et la transmission de données sur un socket.

WSPStartup Le commutateur Windows Sockets n’appelle pas WSPStartup pour démarrer l’opération d’un fournisseur de services SAN. Le commutateur utilise plutôt la fonction WSPStatupEx du fournisseur de services SAN.

WSPStringToAddress Le commutateur Windows Sockets utilise le fournisseur TCP/IP pour convertir une chaîne numérique lisible par l’homme qui représente l’adresse IP d’un socket en une structure d’adresse de socket (SOCKADDR) appropriée pour passer aux routines Windows Sockets qui utilisent une telle structure.