WSK_SET_STATIC_EVENT_CALLBACKS

Une application WSK utilise l’opération de contrôle client WSK_SET_STATIC_EVENT_CALLBACKS pour activer automatiquement certaines fonctions de rappel d’événements sur chaque socket qu’elle crée. Les fonctions de rappel d’événements activées de cette manière sont toujours activées et ne peuvent pas être désactivées ou réactivée ultérieurement par l’application WSK. Toutefois, si une application WSK active toujours certaines fonctions de rappel d’événements sur chaque socket qu’elle crée, l’application doit utiliser cette méthode pour activer automatiquement ces fonctions de rappel d’événements, car elle génère de bien meilleures performances.

Si une application WSK utilise l’opération de contrôle client WSK_SET_STATIC_EVENT_CALLBACKS, elle doit le faire avant de créer des sockets.

Pour activer automatiquement certaines fonctions de rappel d’événements sur chaque socket qu’elle crée, une application WSK appelle la fonction WskControlClient avec les paramètres suivants.

Paramètre Valeur

ControlCode

WSK_SET_STATIC_EVENT_CALLBACKS

InputSize

sizeof(WSK_EVENT_CALLBACK_CONTROL)

InputBuffer

Pointeur vers une structure de WSK_EVENT_CALLBACK_CONTROL qui spécifie les fonctions de rappel d’événements souhaitées à activer automatiquement

OutputSize

0

OutputBuffer

NULL

OutputSizeReturned

NULL

Irp

NULL

Une application WSK peut spécifier une combinaison d’indicateurs d’événements pour différents types de sockets dans le membre EventMask de la structure WSK_EVENT_CALLBACK_CONTROL . Lorsque l’application WSK crée un nouveau socket, le sous-système WSK active automatiquement les fonctions de rappel d’événements appropriées pour la catégorie spécifique de socket WSK en cours de création.

Pour plus d’informations sur les indicateurs d’événements pour les fonctions de rappel d’événements WSK standard, consultez SO_WSK_EVENT_CALLBACK.

Pour plus d’informations sur l’activation et la désactivation des fonctions de rappel d’événements d’un socket, consultez Activation et désactivation des fonctions de rappel d’événements.

Le paramètre Irp doit avoir la valeur NULL pour cette opération de contrôle client.

Spécifications

Version

Disponible dans Windows Vista et les versions ultérieures des systèmes d’exploitation Windows.

En-tête

Wsk.h (inclure Wsk.h)