OID_SWITCH_PARAMETERS
Un'estensione del commutatore estendibile Hyper-V invia una richiesta di query OID (Object Identifier) di OID_SWITCH_PARAMETERS per ottenere i dati di configurazione dell'opzione estendibile.
Se la richiesta di query OID viene completata correttamente, il membro InformationBuffer della struttura NDIS_OID_REQUEST contiene un puntatore a una struttura NDIS_SWITCH_PARAMETERS.
Osservazioni
Quando l'estensione elabora la struttura NDIS_SWITCH_PARAMETERS restituita, non deve presupporre che i vari membri stringa della struttura NDIS_SWITCH_PARAMETERS, ad esempio SwitchName, siano terminati con null. I tipi di dati per questi membri stringa sono definiti dal tipo dalla struttura IF_COUNTED_STRING. L'estensione 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_PARAMETERS e restituisce uno dei codici di stato seguenti.
| Codice di stato | Descrizione |
|---|---|
NDIS_STATUS_SUCCESS |
Richiesta OID completata. |
NDIS_STATUS_INVALID_LENGTH |
La lunghezza del buffer delle informazioni è troppo piccola per restituire la struttura OID_SWITCH_PARAMETERS per una richiesta di query OID. Il bordo miniport sottostante dell'interruttore estendibile imposta il DATA. QUERY_INFORMATION. BytesNeeded membro nella struttura NDIS_OID_REQUEST alle dimensioni minime del buffer necessarie. |
NDIS_STATUS_FAILURE |
La richiesta non è riuscita per altri motivi. |
Fabbisogno
Versione |
Supportato in NDIS 6.30 e versioni successive. |
Intestazione |
Ntddndis.h (include Ndis.h) |