FN_VMB_CHANNEL_INIT_SET_PROCESS_PACKET_CALLBACKS Rückruffunktion (vmbuskernelmodeclientlibapi.h)
[Einige Informationen beziehen sich auf vorab veröffentlichte Produkte, die vor der kommerziellen Veröffentlichung erheblich geändert werden können. Microsoft übernimmt keine Gewährleistungen, ausdrücklich oder konkludent in Bezug auf die hier bereitgestellten Informationen.]
Die VmbChannelInitSetProcessPacketCallbacks Funktion setzt Rückruffunktionen für die Paketverarbeitung.
Syntax
FN_VMB_CHANNEL_INIT_SET_PROCESS_PACKET_CALLBACKS FnVmbChannelInitSetProcessPacketCallbacks;
NTSTATUS FnVmbChannelInitSetProcessPacketCallbacks(
VMBCHANNEL Channel,
PFN_VMB_CHANNEL_PROCESS_PACKET ProcessPacketCallback,
PFN_VMB_CHANNEL_PROCESSING_COMPLETE ProcessingCompleteCallback
)
{...}
Parameter
Channel
Ein Handle für den Kanal.
ProcessPacketCallback
Eine Rückruffunktion, die aufgerufen werden soll, wenn ein Paket zur Verarbeitung bereit ist.
ProcessingCompleteCallback
Eine Rückruffunktion, die aufgerufen werden soll, wenn die Verarbeitung eines Paketbatches abgeschlossen wurde.
Rückgabewert
VmbChannelInitSetProcessPacketCallbacks einen der folgenden Statuswerte zurück:
| Rückgabecode | Beschreibung |
|---|---|
|
Die Funktion wurde erfolgreich abgeschlossen. |
|
Der Channel- Wert war ungültig oder in einem ungültigen Zustand, z. B. "Deaktiviert". |
Bemerkungen
Diese Funktion ist nur dann sinnvoll, wenn die KmCL-Warteschlangenverwaltung (Kernel Mode Client Library) nicht unterdrückt wird.
ProcessPacketCallback- für jedes empfangene Paket aufgerufen wird. EvtVmbChannelProcessingComplete jedes Mal aufgerufen werden, wenn der Ringpuffer, der eingehende Pakete enthält, von nicht leer zu leer wechselt. Dies geschieht nach dem letzten Aufruf von ProcessPacketCallback- in einem einzelnen Batch.
Wichtig
Diese Funktion wird über die KMCL-Schnittstelle (VMBus Kernel Mode Client Library) aufgerufen, die vom Vmbkmcl.sys Bustreiber bereitgestellt wird. Dies ist eine Clientfunktion, auf die über die KMCL_CLIENT_INTERFACE_V1 Struktur zugegriffen wird.
Weitere Informationen finden Sie im Abschnitt "Hinweise" des KMCL_CLIENT_INTERFACE_V1.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows 10, Version 1803 |
| Header- | vmbuskernelmodeclientlibapi.h |