FN_VMB_SERVER_CHANNEL_INIT_SET_TARGET_INTERFACE_ID Rückruffunktion (vmbuskernelmodeclientlibapi.h)

Artikel
02/07/2025

Die VmbServerChannelInitSetTargetInterfaceId Funktion legt die GUID des Zielschnittstellentyps und die Instanz-GUID des Kanalangebots fest.

Syntax

FN_VMB_SERVER_CHANNEL_INIT_SET_TARGET_INTERFACE_ID FnVmbServerChannelInitSetTargetInterfaceId;

NTSTATUS FnVmbServerChannelInitSetTargetInterfaceId(
  VMBCHANNEL Channel,
  GUID InterfaceType,
  GUID InterfaceInstance
)
{...}

Parameter

Channel

Ein Handle für einen Kanal.

InterfaceType

Ein Zeiger auf die GUID des Schnittstellentyps.

InterfaceInstance

Ein Zeiger auf die Instanztyp-GUID.

Rückgabewert

Gibt STATUS_SUCCESS zurück, wenn der Vorgang erfolgreich ist. Andernfalls wird ein entsprechender NTSTATUS-Fehlercode zurückgegeben.

Bemerkungen

Die InterfaceType GUID identifiziert den Kanaltyp und insbesondere das Protokoll, das mit dem Kanal verwendet wird. Wenn der VMBus in der untergeordneten Partition ein physisches Geräteobjekt (Physical Device Object, PDO) erstellt, das diesem Kanal zugeordnet ist, ist diese GUID die Basis der Hardware-ID der PDO, die dem PnP-Manager gemeldet wurde.

Die InterfaceInstance GUID identifiziert eine bestimmte Instanz des Diensts. Wenn Sie beispielsweise über zwei paravirtuale Netzwerkschnittstellen verfügen, verfügen sie über denselben Schnittstellentyp, aber über unterschiedliche Schnittstelleninstanzwerte.

Wichtig

Diese Funktion wird über die KMCL-Schnittstelle (VMBus Kernel Mode Client Library) aufgerufen, die vom Vmbkmcl.sys Bustreiber bereitgestellt wird. Dies ist eine servergeschützte Funktion, auf die über die KMCL_SERVER_ONLY_METHODS-Struktur zugegriffen wird.

Weitere Informationen finden Sie im Abschnitt "Hinweise" von KMCL_SERVER_ONLY_METHODS.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows 10, Version 1809
Header-	vmbuskernelmodeclientlibapi.h

Freigeben über