OID_GEN_ISOLATION_PARAMETERS
I driver NDIS e overlying eseguono una richiesta OID (Object Identifier) di OID_GEN_ISOLATION_PARAMETERS per ottenere i parametri di configurazione multi-tenancy (isolamento) impostati sulla porta della scheda di rete della macchina virtuale.
Anche se ogni dominio di routing viene configurato separatamente sulla porta, questo OID restituisce i parametri per tutti i domini di routing in una singola query.
Un driver overlying deve eseguire questo OID in due passaggi:
- Eseguire una query di Io sulla dimensione del buffer richiesta, eseguire la query OID con il membro Size del membro Header della struttura NDIS_ISOLATION_PARAMETERS impostata su NDIS_SIZEOF_NDIS_ISOLATION_PARAMETERS_REVISION_1. Vedere NDIS_STATUS_INVALID_LENGTH di seguito.
- Rilasciare l'OID con un InformationBuffer delle dimensioni necessarie.
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, in ordine:
Struttura NDIS_ISOLATION_PARAMETERS
Una o più strutture NDIS_ROUTING_DOMAIN_ENTRY , una per ogni dominio di routing
Una o più strutture NDIS_ROUTING_DOMAIN_ISOLATION_ENTRY , raggruppate per dominio di routing
In ogni struttura NDIS_ROUTING_DOMAIN_ENTRY , il membro FirstIsolationInfoEntryOffset contiene l'offset dall'inizio del buffer delle informazioni OID, ovvero l'inizio del buffer a cui punta il membro InformationBuffer della struttura NDIS_OID_REQUEST ) al primo NDIS_ROUTING_DOMAIN_ISOLATION_ENTRY per tale dominio di routing. L'offset nel membro NextIsolationInfoEntryOffset dell'ultima struttura nell'elenco è zero.
Se nella scheda di rete della macchina virtuale non sono impostati parametri di configurazione multi-tenancy, il driver miniport della scheda di rete imposta i dati. QUERY_INFORMATION. Membro BytesWritten della struttura NDIS_OID_REQUEST su zero e restituisce NDIS_STATUS_SUCCESS. In questo caso, i dati all'interno dei DATI. QUERY_INFORMATION. Il membro InformationBuffer non viene modificato dal driver miniport.
Commenti
Codici di stato restituiti
Il driver miniport della scheda di rete della macchina virtuale restituisce uno dei codici di stato seguenti per questa richiesta OID:
| 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 le informazioni richieste. Il driver miniport della scheda di rete della macchina virtuale imposta i dati. METHOD_INFORMATION. Membro BytesNeeded nella struttura NDIS_OID_REQUEST alle dimensioni minime del buffer, in byte, necessarie. |
NDIS_STATUS_FAILURE |
La richiesta non è riuscita per altri motivi. |
Requisiti
Versione |
Supportato in NDIS 6.40 e versioni successive. |
Intestazione |
Ntddndis.h (include Ndis.h) |