Compartir a través de

FN_VMB_CHANNEL_RESTORE_FROM_BUFFER función de devolución de llamada (vmbuskernelmodeclientlibapi.h)

  • Artículo

[Cierta información se relaciona con el producto publicado previamente que puede modificarse sustancialmente antes de su publicación comercial. Microsoft no ofrece ninguna garantía, expresa o implícita, con respecto a la información proporcionada aquí.]

La función VmbChannelRestoreFromBuffer restaura el estado del cliente a partir del estado guardado anteriormente. El controlador debe comprobar el valor devuelto de la función.

Sintaxis

FN_VMB_CHANNEL_RESTORE_FROM_BUFFER FnVmbChannelRestoreFromBuffer;

NTSTATUS FnVmbChannelRestoreFromBuffer(
  VMBCHANNEL Channel,
  PVOID Buffer,
  ULONG BufferSize
)
{...}

Parámetros

Channel

Identificador de un canal.

Buffer

Puntero a un búfer que contiene el estado guardado anteriormente.

BufferSize

Tamaño, en bytes, del búfer.

Valor devuelto

VmbChannelRestoreFromBuffer devuelve uno de los siguientes valores de estado:

Código devuelto Descripción
STATUS_SUCCESS
 La función finalizó correctamente.
STATUS_MORE_PROCESSING_REQUIRED
 El estado se restauró correctamente, pero se guardaron más fragmentos.
otro código de estado para el que NT_SUCCESS es FALSE
 Error en la función.

Observaciones

Se espera que el autor de la llamada llame a esta función con búferes que contienen "fragmentos" completos de datos almacenados.

Importante

Esta función se llama a través de la interfaz de la biblioteca cliente del modo kernel (KMCL) de VMBus, proporcionada por el controlador de bus de Vmbkmcl.sys. Se trata de una función de solo servidor a la que se accede desde la estructura de KMCL_SERVER_ONLY_METHODS.

Para obtener más información, vea la sección Comentarios de KMCL_SERVER_ONLY_METHODS.

Requisitos

Requisito Valor
cliente mínimo admitido Windows 10, versión 1803
encabezado de vmbuskernelmodeclientlibapi.h