OID_SWITCH_PARAMETERS
Un commutatore estendibile Hyper-V genera una richiesta di query OID (Object Identifier) di OID_SWITCH_PARAMETERS per ottenere i dati di configurazione del commutatore 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 .
Commenti
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 valori Null. I tipi di dati per questi membri stringa sono definiti 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 è 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_PARAMETERS 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 informativo è troppo piccola per restituire la struttura di OID_SWITCH_PARAMETERS per una richiesta di query OID. 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) |