EVT_VMB_CHANNEL_SAVE_PACKET funzione di callback (vmbuskernelmodeclientlibapi.h)

  • Articolo

[Alcune informazioni si riferiscono al prodotto pre-rilasciato che può essere modificato in modo sostanziale prima che venga rilasciato commercialmente. Microsoft non offre garanzie, esplicite o implicite, rispetto alle informazioni fornite qui.

La funzione di callback EvtVmbChannelSavePacket viene richiamata quando l'endpoint del provider di servizi di virtualizzazione deve salvare lo stato associato a un pacchetto.

Sintassi

EVT_VMB_CHANNEL_SAVE_PACKET EvtVmbChannelSavePacket;

NTSTATUS EvtVmbChannelSavePacket(
  [in]  VMBCHANNEL Channel,
  [in]  VMBPACKET Packet,
  [out] PVOID SaveBuf,
  [in]  UINT32 SaveBufSize,
  [out] PUINT32 BytesNeeded
)
{...}

Parametri

[in] Channel

Canale in cui arriva il pacchetto.

[in] Packet

Pacchetto per il quale il provider di servizi virtuali salva lo stato.

[out] SaveBuf

Buffer in cui salvare lo stato.

[in] SaveBufSize

Dimensioni del parametro SaveBuf , in byte.

[out] BytesNeeded

Dimensioni necessarie per salvare lo stato della transazione, in byte.

Valore restituito

EvtVmbChannelSavePacket restituisce un codice di stato.

Commenti

La funzione VmbServerChannelInitSetSaveRestorePacketCallbacks imposta una funzione di callback per salvare i pacchetti per ogni canale.

Il provider di servizi virtuali salva lo stato associato alla transazione univoca per il provider di servizi virtuali. La libreria client in modalità kernel (KMCL) salva il proprio stato.

Questa funzione viene richiamata per ogni oggetto pacchetto attualmente in uso. La prima chiamata passa un valore zero (0) per il parametro SaveBufSize . Questa chiamata ha esito negativo se è presente uno stato che deve essere salvato, che riempie i byteNeed con il requisito di dimensione effettiva. Se questa prima chiamata restituisce un codice di errore, l'elenco di controllo delle chiavi chiama una seconda volta con un buffer di almeno la lunghezza specificata nella prima chiamata.

Requisiti

Requisito Valore
Piattaforma di destinazione Windows
Intestazione vmbuskernelmodeclientlibapi.h (includere VmbusKernelModeClientLibApi.h)
IRQL PASSIVE_LEVEL

Vedi anche

VmbServerChannelInitSetSaveRestorePacketCallbacks