OID_SWITCH_NIC_ARRAY
Un commutatore estendibile Hyper-V genera una richiesta di query OID (Object Identifier) di OID_SWITCH_NIC_ARRAY per ottenere una matrice. Ogni elemento della matrice specifica i parametri di configurazione di una scheda di rete virtuale associata a una porta di commutatore estendibile.
Se la richiesta di query OID viene completata correttamente, il membro InformationBuffer della struttura NDIS_OID_REQUEST contiene un puntatore a un buffer. Questo buffer contiene i dati seguenti:
Struttura NDIS_SWITCH_NIC_ARRAY che definisce il numero di elementi nella matrice. Questa struttura specifica anche l'offset del primo elemento della matrice.
Matrice di strutture NDIS_SWITCH_NIC_PARAMETERS . Ognuna di queste strutture contiene informazioni su una scheda di rete connessa a una porta di commutatore estendibile.
Nota Se non sono connesse schede di rete alle porte di commutatore estendibili, il bordo miniport sottostante dell'commutatore estendibile imposta il membro NumElements della struttura NDIS_SWITCH_NIC_ARRAY su zero. In questo caso, non vengono restituite strutture NDIS_SWITCH_NIC_PARAMETERS .
Commenti
L'OID_SWITCH_NIC_ARRAY OID deve essere rilasciato solo quando l'interruttore estendibile Hyper-V ha completato l'attivazione. Per altre informazioni, vedere Querying the Hyper-V Extensible Switch Configuration (Configurazione del commutatore estendibile Hyper-V ).
Quando l'estensione elabora la struttura di NDIS_SWITCH_NIC_PARAMETERS restituita, non deve presupporre che i vari membri stringa della struttura NDIS_SWITCH_PORT_PARAMETERS, ad esempio NicFriendlyName, vengano terminati con null. I tipi di dati per questi membri stringa sono definiti dalla struttura IF_COUNTED_STRING . Il driver deve determinare la lunghezza della stringa dal valore del membro Length di questa struttura.
Nota Se la stringa è terminata con valore Null, il membro Length non deve includere il carattere Null terminante.
Codici di stato restituiti
Il bordo miniport sottostante dell'commutatore estendibile completa la richiesta di query OID di OID_SWITCH_NIC_ARRAY e restituisce uno dei codici di stato seguenti.
| Codice di stato | Descrizione |
|---|---|
NDIS_STATUS_SUCCESS |
La richiesta OID è stata completata correttamente. |
NDIS_STATUS_INVALID_LENGTH |
La lunghezza del buffer delle informazioni è troppo piccola per restituire la NDIS_SWITCH_NIC_ARRAY e la relativa matrice di elementi NDIS_SWITCH_NIC_PARAMETERS . Il bordo miniport sottostante dell'commutatore estendibile 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. |
Requisiti
Versione |
Supportato in NDIS 6.30 e versioni successive. |
Intestazione |
Ntddndis.h (include Ndis.h) |
Vedi anche
Esecuzione di query sulla configurazione del commutatore estendibile Hyper-V
Commenti e suggerimenti
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedere https://aka.ms/ContentUserFeedback.
Invia e visualizza il feedback per