FN_VMB_PACKET_INITIALIZE 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 VmbPacketInitialize inizializza un buffer per contenere un pacchetto VMBus.
Sintassi
FN_VMB_PACKET_INITIALIZE FnVmbPacketInitialize;
NTSTATUS FnVmbPacketInitialize(
VMBCHANNEL Channel,
VMBPACKET VmbPacket,
UINT32 ByteCount
)
{...}
Parametri
Channel
Handle per un canale.
VmbPacket
Buffer da usare per archiviare il pacchetto VMBus.
ByteCount
Dimensioni di Buffer, in byte.
Valore restituito
VmbPacketInitialize restituisce i codici di stato seguenti:
| Codice restituito | Descrizione |
|---|---|
|
La funzione è stata completata correttamente. |
|
Il valore di ByteCount non è valido. Deve essere maggiore delle dimensioni massime del pacchetto più le dimensioni di un puntatore void. |
Osservazioni
Le dimensioni del buffer devono essere almeno le dimensioni calcolate usando la funzione VmbChannelSizeofPacket.
VmbPacketInitialize è un'alternativa alla funzione VmbPacketAllocate. Utilizzare la funzione corrente se il chiamante fornisce la memoria per l'oggetto pacchetto.
La routine di completamento iniziale del pacchetto non è valida e deve essere impostata prima di inviare il pacchetto.
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 |