OID_SRIOV_SET_VF_POWER_STATE
Um driver sobreposto emite uma solicitação de conjunto de OID (identificador de objeto) de OID_SRIOV_SET_VF_POWER_STATE para alterar o estado de energia de uma VF (Função Virtual) PCI Express (PCIe) especificada no adaptador de rede. Como a alteração do estado de energia é uma operação privilegiada, os drivers excessivamente emitem essa solicitação de conjunto de OID para o driver de miniporta da função física PCIe (PF) no adaptador de rede. O driver de miniporta PF define o estado de energia especificado no VF.
O membro InformationBuffer da estrutura NDIS_OID_REQUEST contém um ponteiro para uma estrutura NDIS_SRIOV_SET_VF_POWER_STATE_PARAMETERS .
Comentários
Quando o driver de miniporto PF é emitido essa solicitação de conjunto de OID, ele deve seguir estas diretrizes:
O driver de miniporto PF deve verificar se o VF, especificado pelo membro VFId da estrutura NDIS_SRIOV_SET_VF_POWER_STATE_PARAMETERS , tem recursos que foram alocados anteriormente. O driver de miniporto PF aloca recursos para uma VF durante uma solicitação de método OID de OID_NIC_SWITCH_ALLOCATE_VF. Se o VF especificado não estiver em um estado alocado, o driver deverá falhar na solicitação OID.
A operação de estado de energia só deve afetar o VF especificado. A operação não deve afetar outras VFs ou o PF no mesmo adaptador de rede.
Para obter mais informações, consulte Configurando o estado de energia de uma função virtual.
Códigos de status de retorno
O driver de miniporto PF retorna um dos seguintes códigos de status para a solicitação de conjunto de OID de OID_SRIOV_SET_VF_POWER_STATE.
| 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 de raiz única) ou não está habilitado para usar a interface . |
NDIS_STATUS_INVALID_PARAMETER |
Um ou mais dos membros da estrutura NDIS_SRIOV_SET_VF_POWER_STATE_PARAMETERS têm valores inválidos. |
NDIS_STATUS_INVALID_LENGTH |
O buffer de informações era muito curto. O driver de miniporto PF deve definir o DATA. SET_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) |