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 alcuna garanzia, espressa o implicita, in relazione 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 della dimensione massima del pacchetto più la dimensione di un puntatore void. |
Commenti
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 packet.
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.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 10, versione 1803 |
| Intestazione | vmbuskernelmodeclientlibapi.h |