Compartir a través de

SRIOV_QUERY_VF_LUID función de devolución de llamada (pcivirt.h)

  • Artículo

Obtiene el identificador único local de la función virtual PCI Express SR-IOV (VF).

Sintaxis

SRIOV_QUERY_VF_LUID SriovQueryVfLuid;

NTSTATUS SriovQueryVfLuid(
  [in]  PVOID Context,
  [in]  USHORT VfIndex,
  [out] PLUID Luid
)
{...}

Parámetros

[in] Context

Puntero a un contexto definido por el controlador.

[in] VfIndex

Índice de base cero del VF que se está consultando.

[out] Luid

Puntero al identificador único local del dispositivo SR_IOV que implementa la interfaz.

Valor devuelto

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

Comentarios

Esta función de devolución de llamada se implementa mediante el controlador de función física (PF). Se invoca cuando el sistema quiere obtener el identificador de una función virtual específica.

El controlador PF registra su implementación estableciendo el miembro QueryLuid del SRIOV_DEVICE_INTERFACE_STANDARD_2, configurando una estructura de WDF_QUERY_INTERFACE_CONFIG y llamando a WdfDeviceAddQueryInterface.

Esta es una implementación de ejemplo de esta función de devolución de llamada. El controlador PF genera un identificador único llamando a ZwAllocateLocallyUniqueId y lo almacena en el contexto del dispositivo.


NTSTATUS
Virtualization_QueryLuid (
    _In_        PVOID             Context,
    _Out_       PLUID             Luid
    )
{
    PDEVICE_CONTEXT deviceContext;

    PAGED_CODE();

    deviceContext = (PDEVICE_CONTEXT)Context;
    *Luid = deviceContext->Luid;

    return STATUS_SUCCESS;
}

Requisitos

Requisito Value
Cliente mínimo compatible Windows 10
Servidor mínimo compatible Windows Server 2016
Plataforma de destino Windows
Encabezado pcivirt.h