FN_VMB_CHANNEL_CREATE_GPADL_FROM_BUFFER funzione di callback (vmbuskernelmodeclientlibapi.h)
[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 VmbChannelCreateGpadlFromBuffer crea un elenco GPADL (Guest Physical Address Descriptor List) che descrive un buffer sul lato client. GPADL può essere usato nel server per accedere al buffer.
Sintassi
FN_VMB_CHANNEL_CREATE_GPADL_FROM_BUFFER FnVmbChannelCreateGpadlFromBuffer;
NTSTATUS FnVmbChannelCreateGpadlFromBuffer(
VMBCHANNEL Channel,
UINT32 Flags,
PVOID Buffer,
UINT32 ByteCount,
PUINT32 GpadlHandle
)
{...}
Parametri
Channel
Handle per un canale.
Flags
Bandiere. I valori possibili sono i seguenti:
Buffer
Buffer, che viene sondato e bloccato fino a quando il GPADL non viene rimosso.
ByteCount
Lunghezza del buffer, in byte.
GpadlHandle
Handle GPADL dell'elenco MDL (Memory Descriptor List) creato. Inviarlo al server da usare con la funzione VmbChannelMapGpadl.
Valore restituito
Restituisce STATUS_SUCCESS se l'operazione ha esito positivo o un codice di errore NTSTATUS appropriato in caso contrario.
Osservazioni
Al termine di questa funzione, l'endpoint server può chiamare VmbChannelMapGpadl, perché VMBus ha già inviato la descrizione GPADL all'endpoint opposto e ha ricevuto la conferma.
È necessario eliminare GPADL usando la funzione VmbChannelDeleteGpadl.
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 |