FN_VMB_CHANNEL_INIT_SET_MAXIMUM_EXTERNAL_DATA funzione di callback (vmbuskernelmodeclientlibapi.h)

  • Articolo

[Alcune informazioni riguardano il prodotto non rilasciato che può essere modificato in modo sostanziale prima che venga rilasciato commercialmente. Microsoft non fornisce alcuna garanzia, espressa o implicita, in relazione alle informazioni fornite qui.

La funzione VmbChannelInitSetMaximumExternalData imposta le dimensioni massime e la lunghezza della catena dei dati descritti da un pacchetto, ma non inviati direttamente nel pacchetto. Ovvero la dimensione massima del buffer descritta da 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.A pointer to a Kernel Mode Client Library (KMCL).

DataSize

Dimensioni massime dei dati esterni.

ChainLength

Numero massimo di descrittori di memoria Elenchi (MDLs) 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 del canale non è valido o non è valido, ad esempio Disabilitato.
STATUS_INVALID_PARAMETER_2
 Il valore DataSize non è valido. Zero (0) non valido.
STATUS_INVALID_PARAMETER_3
 Il valore ChainLength non è valido. Zero (0) non valido.

Commenti

L'elenco di controllo di gestione delle chiavi garantisce che i buffer circolari siano sufficientemente grandi da inviare pacchetti che contengono 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.

Requisiti

Requisito Valore
Client minimo supportato Windows 10, versione 1803
Intestazione vmbuskernelmodeclientlibapi.h