OID_NIC_SWITCH_FREE_VF

Articolo
06/15/2023

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.