Funzioni SPI di Windows Sockets non necessarie per le reti SAN

In questa sezione vengono descritte le funzioni di Windows Sockets SPI che non è necessario implementare da un provider di servizi SAN. Queste funzioni sono definite in Ws2spi.h.

WSPAddressToString
L'opzione Windows Sockets usa il provider TCP/IP per convertire tutti i componenti di una struttura SOCKADDR in una stringa numerica leggibile che rappresenta l'indirizzo IP di un socket.

WSPAsyncSelect
Il commutatore Windows Sockets utilizza internamente il protocollo di sessione per gestire la notifica degli eventi di rete di un socket, se necessario.

WSPCancelBlockingCall
L'opzione Windows Sockets gestisce internamente l'annullamento delle richieste di blocco in corso. Pertanto, non genera mai l'annullamento delle chiamate di blocco a una DLL del provider di servizi SAN. L'opzione Windows Sockets può fare una delle seguenti operazioni:

Annullare una richiesta di connessione in sospeso chiudendo il socket SAN. La DLL del provider di servizi SAN deve interrompere la richiesta di connessione.

Annullare richieste di invio e ricezione in sospeso rimuovendo i dati per tali richieste se il commutatore memorizza i dati internamente o attendendo il completamento di tali richieste se si tratta di trasferimenti RDMA da o verso buffer dell'applicazione. Per i trasferimenti RDMA lunghi, l'opzione può chiudere completamente la connessione.

La documentazione di Windows Sockets SPI in Microsoft Windows SDK avvisa che se una chiamata di blocco viene annullata, un'applicazione non può basarsi su una connessione mantenuta. In questo caso, l'unica chiamata garantita di riuscire sul socket dopo l'annullamento di una richiesta bloccante è WSPCloseSocket.

WSPGetPeerName L'opzione Windows Sockets memorizza nella cache l'indirizzo IP di un peer quando l'opzione stabilisce una connessione al peer in una chiamata WSPConnect o accetta una connessione al peer in una chiamata WSPAccept. L'opzione fornisce questo valore memorizzato nella cache alle applicazioni, se necessario.

WSPGetSockName L'opzione Windows Sockets memorizza nella cache l'indirizzo IP locale per un socket quando l'opzione associa l'indirizzo al socket in una chiamata WSPBind o accetta una connessione a un peer in una chiamata WSPAccept. L'opzione fornisce questo valore memorizzato nella cache alle applicazioni, se necessario.

WSPJoinLeaf L'opzione Windows Sockets usa esclusivamente il provider TCP/IP per gestire le sessioni multipoint.

WSPRecvDisconnect L'opzione Windows Sockets gestisce internamente la terminazione della ricezione dei dati in un socket e recupera i dati di disconnessione in ingresso dall'entità remota.

WSPRecvFrom La versione corrente di Windows Sockets Direct non supporta i provider di servizi SAN che gestiscono socket che ricevono datagrammi con semantica UDP (User Datagram Protocol). Di conseguenza, lo switch di Windows Sockets chiama la funzione WSPRecv di un provider di servizi SAN su un socket connesso per ricevere i dati di flusso secondo la semantica del Transmission Control Protocol (TCP).

WSPSelect L'interruttore Windows Sockets usa internamente il suo protocollo di sessione in collaborazione con il provider TCP/IP per determinare lo stato dei socket, se necessario.

WSPSendDisconnect L'opzione Windows Sockets gestisce internamente la terminazione della connessione per un socket e invia dati di disconnessione all'entità remota.

WSPSendTo La versione corrente di Windows Sockets Direct non supporta i provider di servizi SAN che gestiscono socket che inviano datagrammi con semantica UDP (User Datagram Protocol). Di conseguenza, l'opzione Windows Sockets chiama la funzione WSPSend di un provider di servizi SAN su un socket connesso per inviare dati di flusso con semantica TCP (Transmission Control Protocol).

WSPShutdown L'opzione Windows Sockets disabilita internamente la ricezione e la trasmissione dei dati su un socket.

WSPStartup Il commutatore di Windows Sockets non chiama WSPStartup per iniziare il funzionamento di un provider di servizi SAN. La funzione WSPStatupEx del provider di servizi SAN utilizza invece l'interruttore.

WSPStringToAddress Lo switch di Windows Sockets utilizza il provider TCP/IP per convertire una stringa numerica leggibile da esseri umani, che rappresenta l'indirizzo IP di un socket, in una struttura di indirizzo socket (SOCKADDR) adatta per essere passata alle routine di Windows Sockets che accettano tale struttura.