FN_VMB_PACKET_INITIALIZE 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 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
STATUS_SUCCESS
 La funzione è stata completata correttamente.
STATUS_INVALID_PARAMETER_3
 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

Vedi anche

VmbChannelSizeofPacket

VmbPacketAllocate