FN_VMB_CHANNEL_INIT_SET_PROCESS_PACKET_CALLBACKS Rückruffunktion (vmbuskernelmodeclientlibapi.h)
[Einige Informationen beziehen sich auf die Vorabversion, die vor der kommerziellen Freigabe möglicherweise wesentlichen Änderungen unterliegt. Microsoft übernimmt für die hier bereitgestellten Informationen keine Gewährleistung, weder ausdrücklicher noch impliziter Art.]
Die VmbChannelInitSetProcessPacketCallbacks-Funktion legt Rückruffunktionen für die Paketverarbeitung fest.
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 ist.
Rückgabewert
VmbChannelInitSetProcessPacketCallbacks gibt einen der folgenden status Werte zurück:
| Rückgabecode | Beschreibung |
|---|---|
|
Die Funktion wurde erfolgreich abgeschlossen. |
|
Der Kanalwert war ungültig oder in einem ungültigen Zustand, z. B. Deaktiviert. |
Hinweise
Diese Funktion ist nur sinnvoll, wenn die KmCL-Warteschlangenverwaltung (Kernel Mode Client Library) nicht unterdrückt wird.
ProcessPacketCallback wird für jedes empfangene Paket aufgerufen. EvtVmbChannelProcessingComplete wird jedes Mal aufgerufen, 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 |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 10, Version 1803 |
| Kopfzeile | vmbuskernelmodeclientlibapi.h |