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

[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 VmbPacketSendWithExternalPfns envía los datos en un búfer de paquetes o datos externos como una matriz de números de fotogramas de página (PFN). La función asocia esos datos al objeto de paquete VMBus, que representa el paquete durante toda la vigencia de la transacción.

Sintaxis

FN_VMB_PACKET_SEND_WITH_EXTERNAL_PFNS FnVmbPacketSendWithExternalPfns;

NTSTATUS FnVmbPacketSendWithExternalPfns(
  __drv_aliasesMem VMBPACKET PacketObject,
  PVOID Buffer,
  UINT32 BufferLength,
  PPFN_NUMBER ExternalDataPfns,
  UINT32 PfnLength,
  UINT32 Flags
)
{...}

Parámetros

PacketObject

Identificador del objeto de paquete VMBus.

Buffer

Búfer que contiene el paquete de comandos que se envía a través del búfer del anillo VMBus.

BufferLength

Longitud, en bytes, del búfer en el parámetro buffer de.

ExternalDataPfns

Matriz de números de fotogramas de página que describen un búfer de datos asociado al paquete.

PfnLength

Número de PFN que se van a enviar desde ExternalDataPfns. El índice final de matriz al que se hace referencia es ExternalDataPfns[PfnOffset+PfnLength-1] inclusivo.

Flags

Banderas. A continuación se muestran marcas pertinentes:

Valor	Significado
VMBUS_CHANNEL_FORMAT_FLAG_WAIT_FOR_COMPLETION	Este paquete no se puede considerar completo y sus recursos no se pueden liberar hasta que un paquete de finalización vuelva del punto de conexión opuesto. Esta marca debe establecerse.
VMBUS_CHANNEL_FORMAT_FLAG_PAGED_BUFFER	El búfer insertado se pagina y debe tratarse en consecuencia, lo que significa que debe copiarse antes de entrar en el nivel DPC. Sondear búferes en modo de usuario o controlar las infracciones de acceso es responsabilidad del autor de la llamada.

Valor devuelto

Devuelve STATUS_SUCCESS si la operación se realiza correctamente o un código de error NTSTATUS adecuado de lo contrario.

Observaciones

Esta función difiere de la función VmbPacketSend en que permite pasar una matriz de PFN, direcciones físicas de forma eficaz.

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 cliente a la que se accede desde la estructura KMCL_CLIENT_INTERFACE_V1.

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

Requisitos

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

Consulte también

VmbPacketSend