OID_NIC_SWITCH_DELETE_SWITCH

Articolo
06/15/2023

NDIS emette una richiesta di set di identificatori di oggetto (OID) di OID_NIC_SWITCH_DELETE_SWITCH per eliminare un commutatore di scheda di interfaccia di rete da una scheda di rete.

NDIS invia questa richiesta OID set al driver miniport della funzione fisica PCI Express (PCIe) della scheda di rete. Questa richiesta di set OID è necessaria per i driver miniport PF che supportano l'interfaccia SR-IOV (Single Root I/O Virtualization).

Nota I driver overlying, ad esempio i driver di protocollo o filtro, non possono eseguire questa richiesta di metodo OID al driver miniport PF.

Il membro InformationBuffer della struttura NDIS_OID_REQUEST contiene un puntatore a una struttura NDIS_NIC_SWITCH_DELETE_SWITCH_PARAMETERS .

Commenti

Una richiesta di set OID di OID_NIC_SWITCH_DELETE_SWITCH elimina un'opzione di interfaccia di rete creata in precedenza tramite una richiesta di metodo OID di OID_NIC_SWITCH_CREATE_SWITCH.

Quando riceve la richiesta del metodo OID di OID_NIC_SWITCH_DELETE_SWITCH, il driver miniport PF deve eseguire le operazioni seguenti:

Se il driver miniport PF supporta la creazione statica e la configurazione dei commutatori di scheda di interfaccia di rete, deve liberare le risorse software associate all'opzione di interfaccia di rete specificata. Tuttavia, il driver può liberare solo le risorse hardware per il commutatore NIC quando viene chiamato MiniportHaltEx .

Per altre informazioni sulla creazione di un commutatore di interfaccia di rete statica, vedere Creazione statica di un commutatore di scheda di interfaccia di rete.
Se il driver miniport PF supporta la creazione dinamica e la configurazione dei commutatori di scheda di interfaccia di rete, deve liberare le risorse hardware e software associate al commutatore NIC specificato.

Per altre informazioni sulla creazione dinamica del commutatore di interfaccia di rete, vedere Creazione dinamica di un commutatore di scheda di interfaccia di rete.
Se il driver miniport PF supporta la creazione dinamica e tutti i commutatori di scheda di interfaccia di rete sono stati eliminati, il driver deve disabilitare la virtualizzazione sulla scheda chiamando NdisMEnableVirtualization. Per disabilitare la virtualizzazione, la scheda di rete deve impostare il parametro EnableVirtualization su FALSE e il parametro NumVFs su zero.

NdisMEnableVirtualization cancella il membro NumVFs e il bit VF Enable nella struttura SR-IOV Extended Capability nello spazio di configurazione PCI del pf della scheda di rete.

Nota Se il driver miniport PF supporta la creazione statica e la configurazione di commutatori di scheda di interfaccia di rete, deve chiamare solo NdisMEnableVirtualization quando viene chiamato MiniportHaltEx .

Per altre informazioni, vedere Eliminazione di un commutatore di scheda di interfaccia di rete.

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 completerà la richiesta in modo asincrono. Al termine dell'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 interrotto 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 è abilitato per l'uso dell'interfaccia .
NDIS_STATUS_FILE_NOT_FOUND	Uno o più membri della struttura NDIS_NIC_SWITCH_DELETE_SWITCH_PARAMETERS hanno valori non validi.
NDIS_STATUS_INVALID_LENGTH	Il buffer delle informazioni è troppo piccolo. NDIS imposta i DATI. SET_INFORMATION. Membro BytesNeeded nella struttura NDIS_OID_REQUEST alle dimensioni minime del buffer necessarie.