Partager via


FN_VMB_CLIENT_CHANNEL_INIT_SET_TARGET_PNP fonction de rappel (vmbuskernelmodeclientlibapi.h)

[Certaines informations concernent le produit préversion qui peut être sensiblement modifié avant sa publication commerciale. Microsoft n’offre aucune garantie, expresse ou implicite, en ce qui concerne les informations fournies ici.]

La fonction VmbClientChannelInitSetTargetPnp définit la cible d’un canal client par type d’interface et id d’instance. Si cette fonction est appelée, la bibliothèque cliente en mode noyau (KMCL) utilise PnP pour rechercher l’objet DDO (Physical Device Object) VMBus qui correspond à l’interface fournie.

Syntaxe

FN_VMB_CLIENT_CHANNEL_INIT_SET_TARGET_PNP FnVmbClientChannelInitSetTargetPnp;

NTSTATUS FnVmbClientChannelInitSetTargetPnp(
  VMBCHANNEL Channel,
  LPCGUID InterfaceType,
  LPCGUID InterfaceInstance,
  PFN_VMB_CHANNEL_PNP_FAILURE PnpFailureCallback
)
{...}

Paramètres

Channel

Pointeur vers un canal.

InterfaceType

Pointeur vers le GUID du type d’interface. Ce GUID identifie le type de canal et le protocole utilisé avec le canal.

InterfaceInstance

Pointeur vers le GUID du type d’instance. Il s’agit d’une instance spécifique du service. S’il n’est pas fourni, une instance avec le type fourni est acceptée.

PnpFailureCallback

Pointeur vers un rappel d’événement pour appeler si l’appareil ne parvient pas à se connecter de façon asynchrone même si l’appareil PnP se trouve.

Valeur de retour

VmbClientChannelInitSetTargetPnp retourne les valeurs suivantes :

Retourner le code Description
STATUS_INVALID_PARAMETER_1
La valeur Channel n’était pas valide ou dans un état non valide, tel que Désactivé.

Remarques

Si vous avez deux interfaces réseau paravirtual, elles auront la même InterfaceType mais différentes valeurs InterfaceInstance.

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 cliente accessible à partir de la structure KMCL_CLIENT_INTERFACE_V1.

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

Exigences

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