Winsock-kernelgebeurtenissen

Het Winsock Kernel-subsysteem (WSK) kan asynchroon een WSK-toepassing waarschuwen wanneer bepaalde socketgebeurtenissen optreden, zoals wanneer nieuwe gegevens zijn ontvangen op een socket of wanneer een socket is losgekoppeld. Als een WSK-toepassing asynchroon op de hoogte moet worden gesteld van socket-gebeurtenissen, moet de WSK-toepassing de juiste callback-functies voor gebeurtenissen implementeren en deze callback-functies voor gebeurtenissen inschakelen op de sockets die worden gemaakt.

Opmerking een WSK-toepassing is niet vereist voor het implementeren of gebruiken van callback-functies voor gebeurtenissen. Een WSK-toepassing kan de meeste WSK-socketbewerkingen uitvoeren door de juiste WSK-socketfuncties aan te roepen. De enige WSK-functie waarvoor het gebruik van callback-functies voor gebeurtenissen vereist is, is de voorwaardelijke acceptatiemodus voor luisterende sockets. Zie Winsock Kernel Functions gebruiken versus Event Callback Functionsvoor meer informatie over de voor- en nadelen van het gebruik van WSK-functies ten opzichte van callbackfuncties voor gebeurtenissen.

Elke WSK socketcategorie ondersteunt een andere set socket-gebeurtenissen.

Basicsockets

Basic sockets bieden geen ondersteuning voor socket-gebeurtenissen.

luisterende sockets

Gebeurtenis	Functie voor gebeurtenisaanroep
Er is een binnenkomende verbinding geaccepteerd.	WskAcceptEvent
Er is een binnenkomende verbindingsaanvraag aangekomen.	WskInspectEvent
Er is een binnenkomende verbindingsaanvraag verwijderd.	WskAbortEvent

* Is alleen van toepassing op luistersockets waarvoor de conditionele acceptatiemodus is ingeschakeld. Voor meer informatie over het gebruik van de modus voor voorwaardelijk accepteren met listening sockets, zie Luisteren naar en accepteren van binnenkomende verbindingen.

Datagram-sockets

Gebeurtenis	Functie voor gebeurtenisaanroep
Een of meer nieuwe datagrammen zijn ontvangen.	WskReceiveFromEvent

Verbindingsgeoriënteerde sockets

Gebeurtenis	Functie voor gebeurtenisaanroep
Er zijn nieuwe gegevens ontvangen.	WskReceiveEvent
De verbinding met de socket is verbroken.	WskDisconnectEvent
De ideale verzendbackloggrootte is gewijzigd.	WskSendBacklogEvent

Wanneer een WSK-toepassing een socket maakt, zijn de event-callbackfuncties van de socket standaard uitgeschakeld. Een WSK-toepassing moet de gebeurtenis-callbackfuncties van een socket inschakelen, zodat het WSK-subsysteem deze kan aanroepen wanneer er socket-gebeurtenissen optreden. Zie voor meer informatie over het in- en uitschakelen van event callback functies van een socket Event Callback Functies Inschakelen en Uitschakelen.

Als een WSK-toepassing een extensie-interface registreert voor een socket, kan de extensie-interface aanvullende gebeurtenissen ondersteunen. Zie Een extensie-interface registrerenvoor meer informatie over het registreren van een extensie-interface voor een socket.

Het WSK-subsysteem kan ook een WSK-toepassing informeren over gebeurtenissen die niet specifiek zijn voor een bepaalde socket. Om een WSK-toepassing op de hoogte te kunnen stellen van deze gebeurtenissen, moet de WSK-toepassing een WskClientEvent callback-functie voor gebeurtenissen implementeren. Er zijn momenteel geen gebeurtenissen gedefinieerd die niet specifiek zijn voor een bepaalde socket. De WskClientEvent-functie van een WSK-toepassing gebeurtenisaanroepfunctie is altijd ingeschakeld en kan niet worden uitgeschakeld.

De event callback-functies van een WSK-toepassing mogen niet wachten op de voltooiing van andere WSK-aanvragen binnen de context van WSK-voltooings- of gebeurtenis-callbackfuncties. De callback kan andere WSK-aanvragen initiëren, ervan uitgaande dat het niet te veel tijd doorbrengt op DISPATCH_LEVEL of de kernelstack uitput, maar het moet niet wachten op hun voltooiing, zelfs niet wanneer de callback wordt aangeroepen bij IRQL = PASSIVE_LEVEL.