options de socket IPPROTO_UDP
Le tableau suivant décrit IPPROTO_UDP options de socket qui s’appliquent aux sockets créés pour les familles d’adresses IPv4 et IPv6 (AF_INET et AF_INET6) avec le paramètre de protocole à la fonction de socket spécifiée en tant qu’UDP (IPPROTO_UDP). Pour plus d’informations sur l’obtention et la définition des options de socket, consultez les pages de référence des fonctions getsockopt etsetockopt.
Pour énumérer les protocoles et découvrir les propriétés prises en charge pour chaque protocole installé, utilisez lesWSAEnumProtocols, WSCEnumProtocolsou fonction WSCEnumProtocols32.
Options
Option | Avoir | Poser | Type Optval | Description |
---|---|---|---|---|
UDP_CHECKSUM_COVERAGE (ws2tcpip.h) | oui | oui | DWORD (booléen) | Lorsque TRUE, les datagrammes UDP sont envoyés avec une somme de contrôle. |
UDP_NOCHECKSUM (ws2tcpip.h) | oui | oui | DWORD (booléen) | Lorsque TRUE, les datagrammes UDP sont envoyés avec la somme de contrôle de zéro. Obligatoire pour les fournisseurs de services. Si un fournisseur de services n’a pas de mécanisme pour désactiver le calcul de somme de contrôle UDP, il peut simplement stocker cette option sans prendre d’action. Cette option n’est pas prise en charge pour IPv6. |
UDP_RECV_MAX_COALESCED_SIZE (ws2ipdef.h ; include ws2tcpip.h) | oui | oui | DWORD | Lorsqu’elles sont définies sur une valeur différente de zéro, plusieurs datagrammes reçus peuvent être fusionnés dans une mémoire tampon de message unique avant d’être indiqués à votre application. La valeur de l’option représente la taille maximale du message en octets pour les messages fusionnés qui peuvent être indiqués à votre application. Les messages non coalescés supérieurs à la valeur d’option peuvent toujours être indiqués. La valeur par défaut est 0 (aucune fusion). Les datagrammes ne seront regroupés que s’ils proviennent de la même adresse source et du même port. Tous les datagrammes coalescés seront de la même taille, à l’exception du dernier datagramme, qui peut être plus petit. Si votre application souhaite récupérer les tailles de datagramme (à l’exception du dernier datagramme, qui peut différer) qui ont été coalescées, vous devez utiliser une API de réception qui prend en charge les informations de contrôle (telles que LPFN_WSARECVMSG (WSARecvMsg)). La taille de tout mais le dernier message se trouve dans le message de contrôle UDP_COALESCED_INFO, qui est de type DWORD. Pour la sécurité des types, votre application doit utiliser les fonctions WSAGetUdpRecvMaxCoalescedSize et WSASetUdpRecvMaxCoalescedSize au lieu de l’option de socket directement. |
UDP_SEND_MSG_SIZE (ws2ipdef.h ; include ws2tcpip.h) | oui | oui | DWORD | Lorsqu’elles sont définies sur une valeur différente de zéro, les mémoires tampons envoyées par votre application sont divisées en plusieurs messages par la pile réseau. La valeur de l’option représente la taille de chaque message décomposé. La valeur de l’option est représentée en octets. La taille du dernier segment peut être inférieure à la valeur de l’option. La valeur par défaut est 0 (aucune segmentation). Votre application doit définir une valeur inférieure à la MTU du chemin d’accès à la ou les destination(s) afin d’éviter la fragmentation IP. Pour la sécurité des types, votre application doit utiliser les fonctions WSAGetUdpSendMessageSize et WSASetUdpSendMessageSize au lieu de l’option de socket directement. |
Prise en charge héritée de Windows pour les options de IPPROTO_UDP
UDP_CHECKSUM_COVERAGE n’est pas disponible sur Windows 2000 et sur Windows NT4. UDP_CHECKSUM_COVERAGE et UDP_NOCHECKSUM ne sont pas disponibles sur Windows 9x/Me.
Remarques
Dans le Kit de développement logiciel (SDK) Microsoft Windows publié pour Windows Vista et versions ultérieures, l’organisation des fichiers d’en-tête a changé et IPPROTO_UDP niveau est défini dans le fichier d’en-tête Ws2def.h qui est automatiquement inclus dans le fichier d’en-tête Winsock2.h. Les options de socket IPPROTO_UDP sont définies dans le fichier d’en-tête Ws2tcpip. h. Le fichier d’en-tête Ws2def.h ne doit jamais être utilisé directement.
Exigences
Exigence | Valeur |
---|---|
En-tête |
|