Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
[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 |
|---|---|
|
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 |