FN_VMB_CLIENT_CHANNEL_INIT_SET_TARGET_PNP 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 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 |
---|---|
|
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 |