Compartilhar via


OID_SRIOV_VF_VENDOR_DEVICE_ID

Um driver sobreposto emite uma solicitação de método OID (identificador de objeto) de OID_SRIOV_VF_VENDOR_DEVICE_ID para consultar o DeviceID (identificador de dispositivo) PCI Express (PCIe) e o Identificador de Fornecedor (VendorID) para um adaptador de rede (VF) PCI Express (PCIe). Esse adaptador de rede virtual é exposto na partição filho do Hyper-V anexada ao VF.

Drivers sobrepostos emitem essa solicitação de método OID para o driver de miniporto da PF (Função Física) PCI Express (PCIe) do adaptador de rede. Essa solicitação de método OID é necessária para drivers de miniporto PF que dão suporte à interface sr-IOV (virtualização de E/S) raiz única.

O membro InformationBuffer da estrutura NDIS_OID_REQUEST contém um ponteiro para uma estrutura NDIS_SRIOV_VF_VENDOR_DEVICE_ID_INFO .

Comentários

Antes de emitir essa solicitação de método OID, o driver sobreposto deve inicializar uma estrutura NDIS_SRIOV_VF_VENDOR_DEVICE_ID_INFO e deve definir o membro VFId como o identificador do VF do qual as informações devem ser lidas.

Quando trata essa solicitação OID, o driver de miniporto PF deve verificar se o VF especificado tem recursos que foram alocados anteriormente. O driver de miniporto PF aloca recursos para um VF durante uma solicitação de método OID de OID_NIC_SWITCH_ALLOCATE_VF. Se os recursos do VF especificado não tiverem sido alocados, o driver deverá falhar na solicitação OID.

Para obter mais informações, consulte Consultando o fornecedor PCI e os identificadores de dispositivo para uma função virtual.

Retornar códigos de status

O driver de miniporto PF retorna um dos seguintes códigos status para a solicitação de método OID de OID_SRIOV_VF_VENDOR_DEVICE_ID.

Código de status Descrição

NDIS_STATUS_SUCCESS

A solicitação OID foi concluída com êxito.

NDIS_STATUS_NOT_SUPPORTED

O driver de miniporto PF não dá suporte à interface sr-IOV (virtualização de E/S raiz) ou não está habilitado para usar a interface.

NDIS_STATUS_INVALID_PARAMETER

Um ou mais dos membros da estrutura NDIS_SRIOV_VF_VENDOR_DEVICE_ID_INFO têm valores inválidos.

NDIS_STATUS_INVALID_LENGTH

O buffer de informações era muito curto. O NDIS define os DADOS. METHOD_INFORMATION. Membro BytesNeeded na estrutura NDIS_OID_REQUEST para o tamanho mínimo do buffer necessário.

NDIS_STATUS_FAILURE

A solicitação falhou por outros motivos.

Requisitos

Versão

Com suporte no NDIS 6.30 e posterior.

Cabeçalho

Ntddndis.h (inclua Ndis.h)

Confira também


NDIS_OID_REQUEST

NDIS_SRIOV_VF_VENDOR_DEVICE_ID_INFO

OID_NIC_SWITCH_ALLOCATE_VF