Funciones SPI de Windows Sockets no necesarias para los SAN
En esta sección se describen las funciones del SPI de Windows Sockets que no es necesario implementar un proveedor de servicios SAN. Estas funciones se definen en Ws2spi.h.
WSPAddressToString
El conmutador Windows Sockets usa el proveedor TCP/IP para convertir todos los componentes de una estructura SOCKADDR en una cadena numérica legible que representa la dirección IP de un socket.
WSPAsyncSelect
El modificador de Windows Sockets usa internamente su protocolo de sesión para controlar la notificación de eventos de red para un socket, si es necesario.
WSPCancelBlockingCall
El modificador de Windows Sockets controla internamente la cancelación de las solicitudes de bloqueo que están en curso. Por lo tanto, nunca emite la cancelación de llamadas de bloqueo a un archivo DLL del proveedor de servicios SAN. El conmutador Windows Sockets puede:
Cancele una solicitud de conexión pendiente cerrando el socket SAN. El archivo DLL del proveedor de servicios SAN debe anular la solicitud de conexión.
Cancele las solicitudes pendientes de envío y recepción descartando los datos de esas solicitudes si el modificador almacena en búferes de datos internamente o esperando a que se completen esas solicitudes si son transferencias RDMA a o desde búferes de aplicaciones. Para transferencias RDMA largas, el conmutador puede cerrar la conexión por completo.
La documentación de SPI de Windows Sockets en el Microsoft Windows SDK advierte de que, si se cancela una llamada de bloqueo, una aplicación no puede confiar en una conexión que se conserva. En este caso, la única llamada que se garantiza que se realice correctamente en el socket después de la cancelación de una solicitud de bloqueo es WSPCloseSocket.
WSPGetPeerName El conmutador de Windows Sockets almacena en caché la dirección IP de un par cuando el conmutador establece una conexión con el mismo nivel en una llamada de WSPConnect o acepta una conexión al mismo nivel en una llamada WSPAccept . El modificador proporciona este valor almacenado en caché a las aplicaciones, si es necesario.
WSPGetSockName El conmutador de Windows Sockets almacena en caché la dirección IP local de un socket cuando el conmutador asocia la dirección con el socket en una llamada WSPBind o acepta una conexión a un par en una llamada WSPAccept . El modificador proporciona este valor almacenado en caché a las aplicaciones, si es necesario.
WSPJoinLeaf El conmutador Windows Sockets usa exclusivamente el proveedor TCP/IP para controlar sesiones de varios puntos.
WSPRecvDisconnect El conmutador de Windows Sockets controla internamente la terminación de la recepción de datos en un socket y recupera los datos de desconexión entrantes de la entidad remota.
WSPRecvFrom La versión actual de Windows Sockets Direct no admite proveedores de servicios SAN que controlan sockets que reciben datagramas con semántica del Protocolo de datagramas de usuario (UDP). Por lo tanto, el conmutador de Windows Sockets llama a la función WSPRecv de un proveedor de servicios SAN en un socket conectado para recibir datos de flujo con la semántica del Protocolo de control de transmisión (TCP).
WSPSelect El modificador de Windows Sockets usa internamente su protocolo de sesión en colaboración con el proveedor TCP/IP para determinar el estado de los sockets, si es necesario.
WSPSendDisconnect El conmutador de Windows Sockets controla internamente la terminación de la conexión de un socket y envía datos desconectados a la entidad remota.
WSPSendTo La versión actual de Windows Sockets Direct no admite proveedores de servicios SAN que controlan sockets que envían datagramas con semántica del Protocolo de datagramas de usuario (UDP). Por lo tanto, el conmutador de Windows Sockets llama a la función WSPSend de un proveedor de servicios SAN en un socket conectado para enviar datos de flujo con semántica del Protocolo de control de transmisión (TCP).
WSPShutdown El conmutador Windows Sockets deshabilita internamente la recepción y transmisión de datos en un socket.
WSPStartup El conmutador Windows Sockets no llama a WSPStartup para iniciar el funcionamiento de un proveedor de servicios SAN. En su lugar, el modificador usa la función WSPStatupEx del proveedor de servicios SAN.
WSPStringToAddress El conmutador Windows Sockets usa el proveedor TCP/IP para convertir una cadena numérica legible que representa la dirección IP de un socket en una estructura de direcciones de socket (SOCKADDR) adecuada para pasar a rutinas de Windows Sockets que toman dicha estructura.