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

Obtiene el identificador único local del dispositivo SR-IOV.

Sintaxis

SRIOV_QUERY_LUID SriovQueryLuid;

NTSTATUS SriovQueryLuid(
  [in]  PVOID Context,
  [out] PLUID Luid
)
{...}

Parámetros

[in] Context

Puntero a un contexto definido por el controlador.

[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.

Observaciones

El controlador de función física (PF) implementa esta función de devolución de llamada. 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, 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	Valor
cliente mínimo admitido	Windows 10
servidor mínimo admitido	Windows Server 2016
de la plataforma de destino de	Windows
encabezado de	pcivirt.h
irQL	PASSIVE_LEVEL