EVT_VMB_CHANNEL_OPENED 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 Rückruffunktion EvtVmbChannelOpened wird aufgerufen, wenn der Clientendpunkt auf dem virtuellen Gastcomputer einen Kanal öffnet, der diesem angeboten wurde.

Syntax

EVT_VMB_CHANNEL_OPENED EvtVmbChannelOpened;

NTSTATUS EvtVmbChannelOpened(
  [in] VMBCHANNEL Channel
)
{...}

Parameter

[in] Channel

Der Kanal, den der virtuelle Gastcomputer öffnet.

Rückgabewert

EvtVmbChannelClosed gibt einen status Code zurück.

Hinweise

Nachdem ein Kanal erstellt wurde, kann ein Clienttreiber Rückruffunktionen für Zustandsänderungen, einschließlich EvtVmbChannelOpened, mithilfe der VMB_CHANNEL_STATE_CHANGE_CALLBACKS_INIT-Funktion angeben.

Nachdem ein Kanal wurde
konfiguriert, ruft der Clientbibliotheksclient (Kernel Mode Client Library, KMCL) die Funktion VmbChannelEnable auf. Auf dem Host bietet diese Funktion dem Gast einen Kanal. Auf dem Gast akzeptiert diese Funktion ein vorhandenes Angebot oder wartet darauf, dass ein solches Angebot eingeht. Wenn ein Kanal geöffnet wird, ruft KMCL die Rückruffunktion EvtVmbChannelOpened auf.
Nach Abschluss dieses Rückrufs befindet sich der Kanal im geöffneten Zustand.

Bevor diese Rückruffunktion aufgerufen wird, können Pakete in die Warteschlange eingereiht, aber nicht gesendet werden.

Wenn der Clienttreiber einen Fehler status Code zurückgibt, führt der Kanal ein Rollback in einen Zustand durch, in dem kein Datenverkehr fließt.

Anforderungen

Anforderung	Wert
Zielplattform	Windows
Kopfzeile	vmbuskernelmodeclientlibapi.h (einschließen VmbusKernelModeClientLibApi.h)
IRQL	PASSIVE_LEVEL

Weitere Informationen

VMB_CHANNEL_STATE_CHANGE_CALLBACKS_INIT

VmbChannelEnable