PFN_WSK_SEND_MESSAGES fonction de rappel (wsk.h)
La fonction WskSendMessages envoie plusieurs datagrammes à une adresse de transport distante.
Syntaxe
PFN_WSK_SEND_MESSAGES PfnWskSendMessages;
NTSTATUS PfnWskSendMessages(
[in] PWSK_SOCKET Socket,
[in] PWSK_BUF_LIST BufferList,
ULONG Flags,
[in, optional] PSOCKADDR RemoteAddress,
[in] ULONG ControlInfoLength,
[In_reads_bytes_opt] PCMSGHDR ControlInfo,
[in, out] PIRP Irp
)
{...}
Paramètres
[in] Socket
Pointeur vers une structure WSK_SOCKET qui spécifie l’objet socket à partir duquel envoyer les datagrammes.
[in] BufferList
Pointeur vers une structure de WSK_BUF_LIST initialisée qui contient la liste des datagrammes à envoyer.
Flags
[Réservé] Ce paramètre est réservé à l’utilisation du système. Une application WSK doit définir ce paramètre sur zéro.
[in, optional] RemoteAddress
Pointeur vers une structure qui spécifie l’adresse de transport distante à laquelle envoyer les datagrammes.
[in] ControlInfoLength
Nombre d’octets de données dans la mémoire tampon pointées par le paramètre ControlInfo. S’il n’existe aucune information de contrôle associée au datagramme, le paramètre ControlInfoLength doit être zéro.
[In_reads_bytes_opt] ControlInfo
Pointeur vers une mémoire tampon qui contient des informations de contrôle associées aux datagrammes envoyés. Les données d’informations de contrôle se composent d’un ou plusieurs objets de données de contrôle, chacun commençant par une structure CMSGHDR. S’il n’existe aucune information de contrôle associée aux datagrammes, ce paramètre doit être null.
ControlInfo ne peut pas être pris en charge par tous les transports.
[in, out] Irp
Pointeur vers un IRP alloué par l’appelant que le sous-système WSK utilise pour terminer l’opération d’envoi de manière asynchrone. Pour plus d’informations sur l’utilisation d’IRPs avec des fonctions WSK, consultez Utilisation d’IRPs avec winsock Kernel Functions.
Valeur de retour
| Retourner le code | Description |
|---|---|
| STATUS_SUCCESS | Les datagrammes ont été envoyés avec succès sur le socket. L’IRP sera terminé avec l’état de réussite. Le champ IoStatus.Information du protocole IRP contient le nombre d’octets envoyés. |
| STATUS_PENDING | Le sous-système WSK n’a pas pu envoyer les datagrammes sur le socket immédiatement. Le sous-système WSK termine l’IRP une fois qu’il a envoyé les datagrammes sur le socket. L’état de l’opération d’envoi est retourné dans le champ IoStatus.Status du protocole IRP. Si l’opération réussit, le champ IoStatus.Information du protocole IRP contient le nombre d’octets envoyés. |
| Autres codes d’état | Une erreur s’est produite. L’IRP est terminé avec l’état d’échec. |
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows 8 |
| d’en-tête | wsk.h (include wsk.h) |