Extensions SPI Windows Sockets pour les réseaux SAP

Cette section fournit une brève description des fonctions d’extension SAN qu’une DLL de fournisseur de services SAN doit fournir. Ces fonctions étendent le SPI windows Sockets pour une utilisation avec un san. Les fonctions étendues sont définies dans Ws2san.h et sont entièrement documentées dans la section Référence directe Windows Sockets.

À l’exception de la fonction WSPStartupEx, les fonctions étendues répertoriées dans cette section sont récupérées par le commutateur Windows Sockets. Pour récupérer le point d’entrée de chacune de ces fonctions étendues, le commutateur Windows Sockets appelle la fonction WSPIoctl d’un fournisseur de services SAN et transmet le code de commande SIO_GET_EXTENSION_FUNCTION_POINTER ainsi que le GUID dont la valeur identifie l’une de ces fonctions étendues.

Un fournisseur de services SAN doit implémenter toutes les fonctions d’extension suivantes à l’exception des fonctions WSPRdmaRead et WSPMemoryRegistrationCacheCallback. Si un fournisseur de services SAN ne prend pas en charge la fonction d’extension WSPRdmaRead ou WSPMemoryRegistrationCacheCallback, sa fonction WSPIoctl doit retourner l’erreur WSAEOPNOTSUPP lorsque le commutateur Windows Sockets demande le point d’entrée à WSPRdmaRead ou WSPMemoryRegistrationCacheCallback.

WSPStartupEx
Lance l’utilisation du commutateur Windows Sockets d’un fournisseur de services SAN.

WSPRegisterMemory
Inscrit un tableau de mémoires tampons qu’un socket utilise comme source locale ou cible locale d’une opération de transfert de données. Un tel socket peut utiliser ce tableau de mémoires tampons comme mémoire tampon source dans WSPRdmaWrite et appels WSPSend et la mémoire tampon de réception dans WSPRdmaRead et appels WSPRecv.

WSPDeregisterMemory
Libère un tableau de mémoires tampons inscrit par un appel précédent à la fonction WSPRegisterMemory.

WSPRegisterRdmaMemory
Inscrit un tableau de mémoires tampons RDMA exposé à une connexion d’homologue distant pour transférer des données vers ou à partir de cette connexion homologue. Un socket sur l’homologue distant peut utiliser ce tableau de mémoires tampons RDMA comme mémoire tampon cible dans un appel WSPRdmaWrite et la mémoire tampon source dans un appel WSPRdmaRead.

WSPDeregisterRdmaMemory
Libère un tableau de mémoires tampons inscrit par un appel précédent à la fonction WSPRegisterRdmaMemory.

WSPMemoryRegistrationCacheCallback
Libère la propriété de la mémoire tampon d’une application et le verrou entre la mémoire tampon et la mémoire physique et supprime la mémoire tampon du cache du fournisseur de services SAN et l’inscription de la mémoire tampon de la carte réseau SAN.

WSPRdmaRead
Transfère les données d’une mémoire tampon RDMA dans l’espace d’adressage auquel l’homologue distant d’un socket peut accéder à une mémoire tampon dans l’espace d’adressage auquel le socket local peut accéder.

WSPRdmaWrite
Transfère les données d’une mémoire tampon source dans l’espace d’adressage qu’un socket local peut accéder à une mémoire tampon RDMA cible dans l’espace d’adressage auquel l’homologue distant du socket peut accéder.