FN_VMB_SERVER_CHANNEL_INIT_SET_TARGET_INTERFACE_ID fonction de rappel (vmbuskernelmodeclientlibapi.h)

La fonction VmbServerChannelInitSetTargetInterfaceId définit le GUID du type d’interface cible et le GUID d’instance de l’offre de canal.

Syntaxe

FN_VMB_SERVER_CHANNEL_INIT_SET_TARGET_INTERFACE_ID FnVmbServerChannelInitSetTargetInterfaceId;

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

Paramètres

Channel

Handle pour un canal.

InterfaceType

Pointeur vers le GUID du type d’interface.

InterfaceInstance

Pointeur vers le GUID du type d’instance.

Valeur de retour

Retourne STATUS_SUCCESS si l’opération réussit. Sinon, retourne un code d’erreur NTSTATUS approprié.

Remarques

Le InterfaceType GUID identifie le type de canal et, plus précisément, le protocole utilisé avec le canal. Si vmBus dans la partition enfant crée un objet PDO (Physical Device Object) associé à ce canal, ce GUID est la base de l’ID matériel de l’objet PDO signalé au Gestionnaire PnP.

L'InterfaceInstance GUID identifie une instance spécifique du service. Par exemple, si vous avez deux interfaces réseau paravirtual, elles ont le même type d’interface, mais différentes valeurs d’instance d’interface.

Important

Cette fonction est appelée par le biais de l’interface KMCL (VmBus Kernel Mode Client Library), fournie par le pilote de bus Vmbkmcl.sys. Il s’agit d’une fonction serveur uniquement accessible à partir de la structure KMCL_SERVER_ONLY_METHODS.

Pour plus d’informations, consultez la section Remarques de KMCL_SERVER_ONLY_METHODS.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 10, version 1809
d’en-tête	vmbuskernelmodeclientlibapi.h