FN_VMB_CHANNEL_INIT_SET_MAXIMUM_EXTERNAL_DATA 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 VmbChannelInitSetMaximumExternalData imposta le dimensioni massime e la lunghezza della catena di dati descritti da un pacchetto, ma non inviati direttamente nel pacchetto. Ovvero, la dimensione massima del buffer descritta da un ExternalDataMdl.

Sintassi

FN_VMB_CHANNEL_INIT_SET_MAXIMUM_EXTERNAL_DATA FnVmbChannelInitSetMaximumExternalData;

NTSTATUS FnVmbChannelInitSetMaximumExternalData(
  VMBCHANNEL Channel,
  UINT32 DataSize,
  UINT32 ChainLength
)
{...}

Parametri

Channel

Puntatore a un canale della libreria client in modalità kernel (KMCL).

DataSize

Dimensione massima dei dati esterni.

ChainLength

Numero massimo di elenchi mdls (Memory Descriptor) in una catena MDL in ingresso.

Valore restituito

VmbChannelInitSetMaximumExternalData può restituire uno dei valori di stato seguenti:

Codice restituito	Descrizione
STATUS_SUCCESS	La funzione è stata completata correttamente.
STATUS_INVALID_PARAMETER_1	Il valore channel non è valido o in uno stato non valido, ad esempio Disabilitato.
STATUS_INVALID_PARAMETER_2	Il valore di DataSize non è valido. Zero (0) non valido.
STATUS_INVALID_PARAMETER_3	Il valore ChainLength non è valido. Zero (0) non valido.

Osservazioni

L'elenco di controllo di gestione delle chiavi garantisce che i buffer circolari siano sufficientemente grandi da inviare pacchetti contenenti buffer nei limiti specificati.

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