FN_VMB_CLIENT_CHANNEL_INIT_SET_TARGET_PNP Rückruffunktion (vmbuskernelmodeclientlibapi.h)

Artikel
08/08/2023

[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 VmbClientChannelInitSetTargetPnp-Funktion legt das Ziel eines Clientkanals nach Schnittstellentyp und instance-IDs fest. Wenn diese Funktion aufgerufen wird, verwendet die Kernel mode Client Library (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 instance Typ-GUID. Dies ist eine bestimmte instance des Diensts. Wenn nicht angegeben, werden alle instance 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 Kanalwert war ungültig oder in einem ungültigen Zustand, z. B. Deaktiviert.

Hinweise

Wenn Sie über zwei paravirtuelle Netzwerkschnittstellen verfügen, verfügen diese über denselben InterfaceType , aber über unterschiedliche InterfaceInstance-Werte .

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

Freigeben über