FN_VMB_CLIENT_CHANNEL_INIT_SET_TARGET_PNP fonction de rappel (vmbuskernelmodeclientlibapi.h)

Article
02/26/2024

[Certaines informations portent sur la préversion du produit, qui est susceptible d’être en grande partie modifié avant sa commercialisation. Microsoft ne donne aucune garantie, expresse ou implicite, concernant les informations fournies ici.]

La fonction VmbClientChannelInitSetTargetPnp définit la cible d’un canal client par type d’interface et instance ID. Si cette fonction est appelée, la bibliothèque cliente en mode noyau (KMCL) utilise PnP pour rechercher l’objet de périphérique physique (PDO) 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 instance. Il s’agit d’un instance spécifique du service. S’il n’est pas fourni, toute instance avec le type fourni est acceptée.

PnpFailureCallback

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

Valeur retournée

VmbClientChannelInitSetTargetPnp retourne les valeurs suivantes :

Code de retour	Description
STATUS_INVALID_PARAMETER_1	La valeur channel n’était pas valide ou dans un état non valide, par exemple Désactivé.

Remarques

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

Important

Cette fonction est appelée par le biais de l’interface KMCL (Kernel Mode Client Library) VMBus, 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 du KMCL_CLIENT_INTERFACE_V1.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 10 version 1803
En-tête	vmbuskernelmodeclientlibapi.h

Partager via