PFN_WSK_SEND_MESSAGES fonction de rappel (wsk.h)

Article
03/05/2024

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 de WSK_SOCKET qui spécifie l’objet socket à partir duquel envoyer les datagrammes.

[in] BufferList

Pointeur vers une structure 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 vers laquelle pointe le paramètre ControlInfo . Si aucune information de contrôle n’est associée au datagramme, le paramètre ControlInfoLength doit être égal à 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 . Si aucune information de contrôle n’est associée aux datagrammes, ce paramètre doit avoir la valeur NULL.

ControlInfo peut ne pas être pris en charge par tous les transports.

[in, out] Irp

Pointeur vers un IRP alloué à 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 des irps avec des fonctions WSK, consultez Utilisation des irps avec les fonctions du noyau Winsock.

Valeur retournée

Code de retour	Description
STATUS_SUCCESS	Les datagrammes ont été correctement envoyés via le socket. Le IRP sera terminé avec succès status. Le champ IoStatus.Information de l’IRP contient le nombre d’octets qui ont été 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. Le status de l’opération d’envoi sera retourné dans le champ IoStatus.Status de l’IRP. Si l’opération réussit, le champ IoStatus.Information de l’IRP contiendra le nombre d’octets qui ont été envoyés.
Autres codes status	Une erreur est survenue. L’IRP sera terminé avec l’échec status.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 8
En-tête	wsk.h (include wsk.h)

Voir aussi

WSK_SOCKET

WSK_BUF_LIST

CMSGHDR

Utilisation des IIP avec les fonctions du noyau Winsock

Partager via