FN_VMB_CLIENT_CHANNEL_INIT_SET_TARGET_PNP Rückruffunktion (vmbuskernelmodeclientlibapi.h)

Artikel
02/07/2025

[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 VmbClientChannelInitSetTargetPnp--Funktion legt das Ziel eines Clientkanals nach Schnittstellentyp und Instanz-IDs fest. Wenn diese Funktion aufgerufen wird, verwendet die Kernelmodus-Clientbibliothek (KMCL) PnP, um das VMBus Physical Device Object (PDO) zu finden, das der bereitgestellten Schnittstelle entspricht.

Syntax

FN_VMB_CLIENT_CHANNEL_INIT_SET_TARGET_PNP FnVmbClientChannelInitSetTargetPnp;

NTSTATUS FnVmbClientChannelInitSetTargetPnp(
  VMBCHANNEL Channel,
  LPCGUID InterfaceType,
  LPCGUID InterfaceInstance,
  PFN_VMB_CHANNEL_PNP_FAILURE PnpFailureCallback
)
{...}

Parameter

Channel

Ein Zeiger auf einen Kanal.

InterfaceType

Ein Zeiger auf die GUID des Schnittstellentyps. Diese GUID identifiziert den Kanaltyp und das Protokoll, das mit dem Kanal verwendet wird.

InterfaceInstance

Ein Zeiger auf die Instanztyp-GUID. Dies ist eine bestimmte Instanz des Diensts. Falls nicht angegeben, wird eine Instanz mit dem angegebenen Typ akzeptiert.

PnpFailureCallback

Ein Zeiger auf einen Ereignisrückruf, der aufgerufen werden soll, wenn das Gerät asynchron keine Verbindung herstellen kann, obwohl sich das PnP-Gerät befindet.

Rückgabewert

VmbClientChannelInitSetTargetPnp gibt die folgenden Werte zurück:

Rückgabecode	Beschreibung
STATUS_INVALID_PARAMETER_1	Der Channel- Wert war ungültig oder in einem ungültigen Zustand, z. B. "Deaktiviert".

Bemerkungen

Wenn Sie über zwei paravirtuale Netzwerkschnittstellen verfügen, weisen sie die gleichen InterfaceType-, aber unterschiedliche InterfaceInstance--Werte auf.

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

Freigeben über