FN_VMB_CLIENT_CHANNEL_INIT_SET_TARGET_PNP funzione di callback (vmbuskernelmodeclientlibapi.h)

Articolo
02/07/2025

[Alcune informazioni riguardano il prodotto non rilasciato che può essere modificato in modo sostanziale prima che venga rilasciato commercialmente. Microsoft non fornisce garanzie, esplicite o implicite, relativamente alle informazioni fornite qui.

La funzione VmbClientChannelInitSetTargetPnp imposta la destinazione di un canale client in base al tipo di interfaccia e agli ID istanza. Se questa funzione viene chiamata, la libreria client in modalità kernel (KMCL) usa PnP per trovare l'oggetto dispositivo fisico VMBus (PDO) che corrisponde all'interfaccia fornita.

Sintassi

FN_VMB_CLIENT_CHANNEL_INIT_SET_TARGET_PNP FnVmbClientChannelInitSetTargetPnp;

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

Parametri

Channel

Puntatore a un canale.

InterfaceType

Puntatore al GUID del tipo di interfaccia. Questo GUID identifica il tipo di canale e il protocollo usato con il canale.

InterfaceInstance

Puntatore al GUID del tipo di istanza. Si tratta di un'istanza specifica del servizio. Se non viene specificato, viene accettata qualsiasi istanza con il tipo specificato.

PnpFailureCallback

Puntatore a un callback di eventi da chiamare se il dispositivo non riesce a connettersi in modo asincrono anche se il dispositivo PnP si trovava.

Valore restituito

VmbClientChannelInitSetTargetPnp restituisce i valori seguenti:

Codice restituito	Descrizione
STATUS_INVALID_PARAMETER_1	Il valore channel non è valido o in uno stato non valido, ad esempio Disabilitato.

Osservazioni

Se si dispone di due interfacce di rete paravirtuali, avranno lo stesso InterfaceType ma valori diversi InterfaceInstance.

Importante

Questa funzione viene chiamata tramite l'interfaccia VMBus Kernel Mode Client Library (KMCL), fornita dal driver del bus di Vmbkmcl.sys. Si tratta di una funzione client a cui si accede dalla struttura KMCL_CLIENT_INTERFACE_V1.

Per altre informazioni, vedere la sezione Osservazioni del KMCL_CLIENT_INTERFACE_V1.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 10, versione 1803
intestazione	vmbuskernelmodeclientlibapi.h

Condividi tramite