OID_SWITCH_PROPERTY_ENUM
Il commutatore estendibile Hyper-V genera una richiesta di metodo OID (Object Identifier) di OID_SWITCH_PROPERTY_ENUM per ottenere una matrice. Questa matrice contiene i criteri di commutatore di cui è stato effettuato il provisioning che corrispondono ai criteri specificati. Ogni elemento nella matrice specifica le proprietà di un criterio di commutatore estendibile.
Il membro InformationBuffer della struttura NDIS_OID_REQUEST contiene un puntatore a un buffer. Questo buffer contiene i dati seguenti:
Struttura NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS che specifica i parametri per l'enumerazione dei criteri di commutatore estendibile.
Matrice di strutture NDIS_SWITCH_PROPERTY_ENUM_INFO . Ognuna di queste strutture contiene informazioni su un criterio di commutatore estendibile.
Nota Se l'estensione non è stata eseguita il provisioning con istanze del criterio di commutatore estendibile specificato, l'estensione imposta il membro NumProperties della struttura NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS su zero e non vengono restituite strutture NDIS_SWITCH_PROPERTY_ENUM_INFO .
Commenti
L'OID_SWITCH_PROPERTY_ENUM 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 ).
A differenza delle richieste di query OID di OID_SWITCH_PORT_PROPERTY_ENUM, l'estensione non deve chiamare alcuna funzione ReferenceSwitchXxx o DereferenceSwitchXxx quando genera la richiesta di OID_SWITCH_PROPERTY_ENUM verso il basso lo stack di driver di commutatore estendibile.
Nota Se l'estensione riceve la richiesta del metodo OID di OID_SWITCH_PROPERTY_ENUM, non deve completare la richiesta OID. Deve invece chiamare NdisFOidRequest per inoltrare la richiesta OID nello stack di driver di commutatore estendibile.
Codici di stato restituiti
Il bordo miniport sottostante del commutatore estendibile completa la richiesta di query OID di OID_SWITCH_PROPERTY_ENUM 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 struttura NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS e la relativa matrice di elementi NDIS_SWITCH_PROPERTY_ENUM_INFO . Il bordo miniport sottostante dell'commutatore estendibile imposta i DATI. METHOD_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
NDIS_SWITCH_PROPERTY_ENUM_INFO
NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS
Esecuzione di query sulla configurazione del commutatore estendibile Hyper-V