FN_VMB_SERVER_CHANNEL_INIT_SET_MMIO_MEGABYTES funzione di callback (vmbuskernelmodeclientlibapi.h)

Articolo
03/05/2024

La funzione VmbServerChannelInitSetMmioMegabytes specifica la quantità, megabyte, dello spazio I/O mappato alla memoria guest (MMIO) da riservare per il dispositivo.

Sintassi

FN_VMB_SERVER_CHANNEL_INIT_SET_MMIO_MEGABYTES FnVmbServerChannelInitSetMmioMegabytes;

NTSTATUS FnVmbServerChannelInitSetMmioMegabytes(
  VMBCHANNEL Channel,
  UINT16 MmioMegabytes,
  UINT16 MmioMegabytesOptional
)
{...}

Parametri

Channel

Handle per un canale.

MmioMegabytes

Quantità di spazio MMIO, in megabyte, da riservare.

MmioMegabytesOptional

Quantità di spazio MMIO facoltativo aggiuntivo, in megabyte, da riservare.

Valore restituito

VmbServerChannelInitSetMmioMegabytes restituisce i valori di stato seguenti:

Codice restituito	Descrizione
STATUS_INVALID_PARAMETER_1	Il valore del canale non è valido o non è valido, ad esempio Disabilitato.
STATUS_INVALID_PARAMETER	Sia MmioMegabytes che MmioMegabytesOptional hanno un valore pari a zero (0). Uno di questi parametri deve essere maggiore di zero

Commenti

Questa funzione esiste come comodità per i creatori di driver. Tutto ciò che può fare può essere fatto interagendo con il gestore plug-and-play guest e richiedendo direttamente lo spazio di I/O mappato alla memoria. È un requisito comune che i driver VMBus Windows e Linux hanno la capacità di riservare spazio MMIO per conto del client. Questa funzione consente all'endpoint server di suggerire la giusta quantità di spazio MMIO da riservare.

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 di sola server a cui si accede dalla struttura KMCL_SERVER_ONLY_METHODS .

Per altre informazioni, vedere la sezione Osservazioni di KMCL_SERVER_ONLY_METHODS.

Requisiti

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

Condividi tramite