Rozszerzenia SPI gniazd systemu Windows dla sieci SAN

Ta sekcja zawiera krótki opis funkcji rozszerzenia SIECI SAN, które musi podać biblioteka DLL dostawcy usług SIECI SAN. Te funkcje rozszerzają spi gniazda systemu Windows do użycia z siecią SAN. Funkcje rozszerzone są definiowane w pliku Ws2san.h i są w pełni udokumentowane w sekcji Windows Sockets Direct Reference.

Z wyjątkiem funkcji WSPStartupEx rozszerzone funkcje wymienione w tej sekcji są pobierane przez przełącznik Windows Sockets. Aby pobrać punkt wejścia do każdej z tych rozszerzonych funkcji, przełącznik Windows Sockets wywołuje WSPIoctl WSPIoctl funkcji i przekazuje kod polecenia SIO_GET_EXTENSION_FUNCTION_POINTER wraz z identyfikatorem GUID, którego wartość identyfikuje jedną z tych rozszerzonych funkcji.

Dostawca usług SAN musi zaimplementować wszystkie następujące funkcje rozszerzenia z wyjątkiem funkcji WSPRdmaRead i WSPMemoryRegistrationCacheCall back. Jeśli dostawca usług SAN nie obsługuje funkcji rozszerzenia WSPRdma Read lub WSPMemoryRegistrationCacheCallback, funkcja WSPIoctl musi zwrócić błąd WSAEOPNOTSUPP, gdy przełącznik Windows Sockets żąda punktu wejścia do WSPRdmaRead lub WSPMemoryRegistrationCacheCallback.

WSPStartupEx
Inicjuje użycie przełącznika Windows Sockets dostawcy usług SIECI SAN.

WSPRegisterMemory
Rejestruje tablicę buforu używaną przez gniazdo jako lokalne źródło lub lokalny element docelowy operacji transferu danych. Takie gniazdo może używać tej tablicy buforu jako buforu źródłowego w WSPRdmaWrite i wywołań usługi WSPSend oraz buforu odbierającego w WSPRdmaRead i wywołań WSPRecv.

WSPDeregisterMemory
Zwalnia tablicę buforu zarejestrowaną przez poprzednie wywołanie funkcji WSPRegisterMemory.

WSPRegisterRdmaMemory
Rejestruje tablicę buforu RDMA uwidocznioną w zdalnym połączeniu równorzędnym na potrzeby przesyłania danych do lub z tego połączenia równorzędnego. Gniazdo w zdalnej komunikacji równorzędnej może używać tej tablicy buforu RDMA jako buforu docelowego w wywołaniu WSPRdmaWrite i buforu źródłowego w wywołaniu WSPRdmaRead.

WSPDeregisterRdmaMemory
Zwalnia tablicę buforu zarejestrowaną przez poprzednie wywołanie funkcji WSPRegisterRdmaMemory.

WSPMemoryRegistrationCacheCallback
Zwalnia własność buforu aplikacji i blokady między buforem a pamięcią fizyczną i usuwa bufor z pamięci podręcznej dostawcy usług SIECI SAN i rejestrację buforu z karty sieciowej SIECI SAN.

WSPRdmaRead
Przesyła dane z buforu RDMA w przestrzeni adresowej, do którego zdalny element równorzędny gniazda może uzyskać dostęp do buforu w przestrzeni adresowej, do którego może uzyskać dostęp lokalne gniazdo.

WSPRdmaWrite
Przesyła dane z buforu źródłowego w przestrzeni adresowej, do którego lokalne gniazdo może uzyskać dostęp do docelowego buforu RDMA w przestrzeni adresowej, do którego może uzyskiwać zdalny dostęp element równorzędny gniazda.