FN_VMB_CHANNEL_INIT_SET_PROCESS_PACKET_CALLBACKS Rückruffunktion (vmbuskernelmodeclientlibapi.h)

  • Artikel

[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
STATUS_SUCCESS
 Die Funktion wurde erfolgreich abgeschlossen.
STATUS_INVALID_PARAMETER_1
 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

Weitere Informationen

EvtVmbChannelProcessingComplete

ProcessPacketCallback