FN_VMB_SERVER_CHANNEL_INIT_SET_TARGET_INTERFACE_ID Rückruffunktion (vmbuskernelmodeclientlibapi.h)

Artikel
03/01/2024

Die Funktion VmbServerChannelInitSetTargetInterfaceId legt den Zielschnittstellentyp GUID und instance 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 den Schnittstellentyp GUID.

InterfaceInstance

Ein Zeiger auf den instance Typ GUID.

Rückgabewert

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

Hinweise

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 (PDO) erstellt, das diesem Kanal zugeordnet ist, ist diese GUID die Grundlage der Hardware-ID des PDO, die an den PnP-Manager gemeldet wird.

Die InterfaceInstance-GUID identifiziert eine bestimmte instance des Diensts. Wenn Sie für instance über zwei paravirtuelle Netzwerkschnittstellen verfügen, verfügen diese über den gleichen Schnittstellentyp, aber unterschiedliche Schnittstellen instance 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 reine Serverfunktion, 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
Unterstützte Mindestversion (Client)	Windows 10, Version 1809
Kopfzeile	vmbuskernelmodeclientlibapi.h

Freigeben über