OID_NIC_SWITCH_ENUM_SWITCHES

Articolo
06/15/2023

Un driver o un'applicazione in modalità utente genera una richiesta di query OID (Object Identifier) di OID_NIC_SWITCH_ENUM_SWITCHES per ottenere una matrice. Ogni elemento della matrice specifica gli attributi di un commutatore di interfaccia di interfaccia di rete creato in una scheda di rete.

Dopo aver restituito correttamente la richiesta di query OID, il membro InformationBuffer della struttura di NDIS_OID_REQUEST contiene un puntatore a un buffer contenente quanto segue:

Struttura NDIS_NIC_SWITCH_INFO_ARRAY che definisce il numero di elementi all'interno della matrice.
Matrice di strutture NDIS_NIC_SWITCH_INFO . Ognuna di queste strutture contiene le informazioni su un singolo commutatore di interfaccia di interfaccia di rete creato nella scheda di rete.

Nota Se la scheda di rete non dispone di commutatori di interfaccia di rete, il driver imposta il membro NumElements della struttura NDIS_NIC_SWITCH_INFO_ARRAY su zero e non vengono restituite strutture NDIS_NIC_SWITCH_INFO .

Commenti

I driver e le applicazioni in modalità utente eseguono richieste di query OID di OID_NIC_SWITCH_ENUM_SWITCHES per enumerare le opzioni di interfaccia di rete create in una scheda di rete.

Nota A partire da Windows Server 2012, l'interfaccia di virtualizzazione I/O (SR-IOV) radice singola supporta solo l'opzione NIC predefinita nella scheda di rete. Pertanto, la struttura NDIS_NIC_SWITCH_INFO_ARRAY restituita deve specificare un singolo elemento NDIS_NIC_SWITCH_INFO per l'opzione NIC predefinita, a cui fa riferimento l'identificatore di NDIS_DEFAULT_SWITCH_ID .

Codici di stato restituiti

NDIS gestisce la richiesta di query OID della richiesta di OID_NIC_SWITCH_ENUM_SWITCHES per i driver miniport. I driver non verranno emessi questa richiesta OID.

Quando NDIS gestisce la richiesta di OID_NIC_SWITCH_ENUM_SWITCHES, restituisce uno dei codici di stato seguenti.

Codice di stato	Descrizione
NDIS_STATUS_SUCCESS	La richiesta OID è stata completata correttamente.
NDIS_STATUS_NOT_SUPPORTED	Il driver miniport non supporta l'interfaccia SR-IOV o non è abilitata per l'uso dell'interfaccia.
NDIS_STATUS_INVALID_PARAMETER	Uno o più membri della struttura NDIS_NIC_SWITCH_INFO_ARRAY hanno valori non validi.
NDIS_STATUS_INVALID_LENGTH	Il buffer delle informazioni era troppo breve. NDIS imposta i DATI. QUERY_INFORMATION. Membro ByteNeeded nella struttura NDIS_OID_REQUEST alla dimensione minima del buffer necessaria.
NDIS_STATUS_FAILURE	La richiesta non è riuscita per altri motivi.