OID_SWITCH_PORT_ARRAY
Un'estensione del commutatore estendibile Hyper-V genera una richiesta di query OID (Object Identifier) di OID_SWITCH_PORT_ARRAY per ottenere una matrice. Ogni elemento nella matrice specifica i parametri di configurazione per una porta del 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_PORT_ARRAY che definisce il numero di elementi all'interno della matrice.
Matrice di strutture NDIS_SWITCH_PORT_PARAMETERS . Ognuna di queste strutture contiene informazioni su una porta sul commutatore estendibile.
Nota Se nel commutatore estendibile non sono state create porte, il driver imposta il membro NumElements della struttura NDIS_SWITCH_PORT_ARRAY su zero e non vengono restituite strutture NDIS_SWITCH_PORT_PARAMETERS .
Commenti
L'OID OID_SWITCH_PORT_ARRAY deve essere generato solo quando l'opzione estendibile Hyper-V ha completato l'attivazione. Per altre informazioni, vedere Esecuzione di query sulla configurazione del commutatore estendibile Hyper-V .
Quando l'estensione gestisce la struttura NDIS_SWITCH_PORT_PARAMETERS restituita, non deve presupporre che i vari membri stringa della struttura NDIS_SWITCH_PORT_PARAMETERS , ad esempio PortName, siano terminati con null. I tipi di dati per questi membri stringa sono definiti dal tipo 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 è con terminazione Null, il membro Length non deve includere il carattere Null di terminazione.
Codici di stato restituiti
Il bordo miniport sottostante dell'interruttore estendibile completa la richiesta di query OID di OID_SWITCH_PORT_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 il NDIS_SWITCH_PORT_ARRAY e la relativa matrice di elementi NDIS_SWITCH_PORT_PARAMETERS . Il bordo miniport sottostante dell'interruttore estendibile imposta i dati. QUERY_INFORMATION. Membro BytesNeeded nella struttura NDIS_OID_REQUEST alle dimensioni minime del buffer necessarie. |
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