Compartilhar via

SRIOV_QUERY_LUID função de retorno de chamada (pcivirt.h)

  • Artigo

Obtém o identificador exclusivo local do dispositivo SR-IOV.

Sintaxe

SRIOV_QUERY_LUID SriovQueryLuid;

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

Parâmetros

[in] Context

Um ponteiro para um contexto definido pelo driver.

[out] Luid

Um ponteiro para o identificador exclusivo local do dispositivo SR_IOV implementando a interface.

Retornar valor

Retorne STATUS_SUCCESS se a operação for bem-sucedida. Caso contrário, retorne um código de erro NTSTATUS apropriado.

Comentários

Essa função de retorno de chamada é implementada pelo driver PF (função física). Ele é invocado quando o sistema deseja obter o identificador de uma função virtual específica.

O driver PF registra sua implementação definindo o membro QueryLuid do SRIOV_DEVICE_INTERFACE_STANDARD, configurando uma estrutura WDF_QUERY_INTERFACE_CONFIG e chamando WdfDeviceAddQueryInterface.

Aqui está um exemplo de implementação dessa função de retorno de chamada. O driver PF gera um identificador exclusivo chamando ZwAllocateLocallyUniqueId e o armazena no contexto do 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 com suporte Windows 10
Servidor mínimo com suporte Windows Server 2016
Plataforma de Destino Windows
Cabeçalho pcivirt.h
IRQL PASSIVE_LEVEL