OID_NIC_SWITCH_DELETE_SWITCH

Articolo
03/13/2025

NDIS rilascia una richiesta di set OID (Object Identifier) di OID_NIC_SWITCH_DELETE_SWITCH per eliminare un commutatore NIC da una scheda di rete.

NDIS rilascia questa richiesta di set OID 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 di virtualizzazione di I/O radice singola (SR-IOV).

Nota driver overlying, ad esempio 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.

Osservazioni

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 al commutatore NIC specificato. Tuttavia, il driver può liberare solo le risorse hardware per il commutatore NIC quando viene chiamato MiniportHaltEx.

Per altre informazioni sulla creazione di commutatori NIC statici, vedere Creazione statica di un commutatore 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 NIC, vedere Creazione dinamica di un commutatore di interfaccia di rete.
Se il driver miniport PF supporta la creazione dinamica e tutti i commutatori della 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 VF Enable bit nella struttura delle funzionalità estese SR-IOV nello spazio di configurazione PCI del pf della scheda di rete.

Nota Se il driver miniport PF supporta la creazione statica e la configurazione dei commutatori NIC, 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 di miniportOidRe quest 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. Dopo aver completato tutta l'elaborazione, il driver miniport deve avere esito positivo chiamando la funzione NdisMOidRequestComplete, passando NDIS_STATUS_SUCCESS per il parametro stato.
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 funzioneminiportResetEx.

NDIS restituisce uno dei codici di stato seguenti per questa richiesta:

Termine	Descrizione
NDIS_STATUS_SUCCESS	Richiesta OID completata.
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_DELETE_SWITCH_PARAMETERS hanno valori non validi.
NDIS_STATUS_INVALID_LENGTH	Il buffer delle informazioni è troppo piccolo. NDIS imposta l'DATA. SET_INFORMATION. BytesNeeded membro nella struttura NDIS_OID_REQUEST alle dimensioni minime del buffer necessarie.