OID_NIC_SWITCH_FREE_VF
Un driver overlying genera una richiesta di set di identificatori di oggetto (OID) di OID_NIC_SWITCH_FREE_VF per liberare le risorse per la funzione virtuale PCI Express (PCIe) di una scheda di rete.
I driver overlying emettono questa richiesta impostata su OID sul driver miniport per la funzione fisica PCIe della scheda di rete(PF). Questa richiesta di set OID è necessaria per i driver miniport PF che supportano l'interfaccia di virtualizzazione I/O (SR-IOV) singola.
Il membro InformationBuffer della struttura NDIS_OID_REQUEST contiene un puntatore a una struttura NDIS_NIC_SWITCH_FREE_VF_PARAMETERS .
Il driver overlying specifica l'identificatore del VF da liberare tramite il membro VFId di questa struttura. Il driver ha ottenuto questo identificatore da una richiesta di metodo OID precedente di OID_NIC_SWITCH_ALLOCATE_VF.
Commenti
Un driver overlying genera una richiesta OID set di OID_NIC_SWITCH_FREE_VF per liberare le risorse per un VF. Queste risorse sono state assegnate in precedenza tramite una richiesta di metodo OID di OID_NIC_SWITCH_ALLOCATE_VF.
Per altre informazioni su come liberare risorse VF, vedere Liberare risorse per una funzione virtuale.
Nota Una volta che un driver overlying richiede l'allocazione delle risorse per un VF, tale driver è l'unico componente che può richiedere la liberazione delle risorse per lo stesso VF. Il driver overlying deve emettere una richiesta OID set di OID_NIC_SWITCH_FREE_VF per liberare le risorse VF. Prima che il driver overlying possa essere arrestato, deve liberare le risorse per ogni VF allocato dalla richiesta di OID_NIC_SWITCH_ALLOCATE_VF del driver.
Codici di stato restituiti
La funzione MiniportOidRequest del driver miniport restituisce uno dei valori seguenti per questa richiesta:
| Termine | Descrizione |
|---|---|
NDIS_STATUS_SUCCESS |
Il driver miniport ha completato correttamente la richiesta. |
NDIS_STATUS_PENDING |
Il driver miniport completa la richiesta in modo asincrono. Dopo aver completato l'elaborazione, il driver miniport deve avere esito positivo alla richiesta chiamando la funzione NdisMOidRequestComplete , passando NDIS_STATUS_SUCCESS per il parametro Status . |
NDIS_STATUS_NOT_ACCEPTED |
Il driver miniport viene reimpostato. |
NDIS_STATUS_REQUEST_ABORTED |
Il driver miniport ha arrestato l'elaborazione della richiesta. Ad esempio, NDIS ha chiamato la funzione MiniportResetEx . |
NDIS restituisce uno dei codici di stato seguenti per questa richiesta:
| Termine | Descrizione |
|---|---|
NDIS_STATUS_SUCCESS |
La richiesta OID è stata completata correttamente. |
NDIS_STATUS_NOT_SUPPORTED |
Il driver miniport PF non supporta l'interfaccia SR-IOV o non è abilitata per l'uso dell'interfaccia. |
NDIS_STATUS_FILE_NOT_FOUND |
Uno o più membri della struttura NDIS_NIC_SWITCH_FREE_VF_PARAMETERS hanno valori non validi. Ad esempio, il membro VFId potrebbe specificare un VF che non è stato allocato o che non è stato eliminato. |
NDIS_STATUS_INVALID_LENGTH |
Il buffer delle informazioni è troppo piccolo. NDIS imposta i DATI. SET_INFORMATION. Membro ByteNeeded nella struttura NDIS_OID_REQUEST alla dimensione minima del buffer necessaria. |
Requisiti
Versione |
Supportato in NDIS 6.30 e versioni successive. |
Intestazione |
Ntddndis.h (include Ndis.h) |