Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Un driver overlying rilascia una richiesta di set OID (Object Identifier) di OID_SRIOV_SET_VF_POWER_STATE per modificare lo stato di alimentazione di una funzione virtuale PCI Express (PCIe) specificata nella scheda di rete. Poiché la modifica dello stato di alimentazione è un'operazione con privilegi, i driver overlying rilasciano questa richiesta OID set al driver miniport della funzione fisica PCIe (PF) sulla scheda di rete. Il driver miniport PF imposta quindi lo stato di alimentazione specificato sul VF.
Il membro InformationBuffer della struttura NDIS_OID_REQUEST contiene un puntatore a una struttura NDIS_SRIOV_SET_VF_POWER_STATE_PARAMETERS.
Osservazioni
Quando il driver miniport PF viene emesso questa richiesta di set OID, deve seguire queste linee guida:
Il driver miniport PF deve verificare che il VF, specificato dal VFId membro della struttura NDIS_SRIOV_SET_VF_POWER_STATE_PARAMETERS, disponga di risorse allocate in precedenza. Il driver miniport PF alloca le risorse per un VF durante una richiesta di metodo OID di OID_NIC_SWITCH_ALLOCATE_VF. Se l'oggetto VF specificato non è in uno stato allocato, il driver deve non riuscire la richiesta OID.
L'operazione relativa allo stato di alimentazione deve influire solo sul VF specificato. L'operazione non deve influire su altre macchine virtuali o pf nella stessa scheda di rete.
Per altre informazioni, vedere Impostazione dello stato di alimentazione di una funzione virtuale.
Codici di stato restituiti
Il driver miniport PF restituisce uno dei codici di stato seguenti per la richiesta di set OID di OID_SRIOV_SET_VF_POWER_STATE.
Codice di stato | Descrizione |
---|---|
NDIS_STATUS_SUCCESS |
Richiesta OID completata. |
NDIS_STATUS_NOT_SUPPORTED |
Il driver miniport PF non supporta l'interfaccia di virtualizzazione I/O radice singola (SR-IOV) o non è abilitata per l'uso dell'interfaccia. |
NDIS_STATUS_INVALID_PARAMETER |
Uno o più membri della struttura NDIS_SRIOV_SET_VF_POWER_STATE_PARAMETERS hanno valori non validi. |
NDIS_STATUS_INVALID_LENGTH |
Il buffer delle informazioni era troppo breve. Il driver miniport PF deve impostare il DATA. SET_INFORMATION. BytesNeeded membro nella struttura NDIS_OID_REQUEST alle dimensioni minime del buffer necessarie. |
NDIS_STATUS_FAILURE |
La richiesta non è riuscita per altri motivi. |
Fabbisogno
Versione |
Supportato in NDIS 6.30 e versioni successive. |
Intestazione |
Ntddndis.h (include Ndis.h) |