Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
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 emettere questo OID in due passaggi:
- Eseguire una query 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 in base al dominio di routing
In ogni struttura NDIS_ROUTING_DOMAIN_ENTRY, il membro FirstIsolationInfoEntryOffset contiene l'offset dall'inizio del buffer delle informazioni dell'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. Offset nell'NextIsolationInfoEntryOffset membro 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 il DATA. QUERY_INFORMATION. Byte Scritti membro della struttura NDIS_OID_REQUEST su zero e restituisce NDIS_STATUS_SUCCESS. In questo caso, i dati all'interno dell'DATA. QUERY_INFORMATION. InformationBuffer membro non viene modificato dal driver miniport.
Osservazioni
Codici di stato restituiti
Il driver miniport della scheda di rete vm restituisce uno dei codici di stato seguenti per questa richiesta OID:
| Codice di stato | Descrizione |
|---|---|
NDIS_STATUS_SUCCESS |
Richiesta OID completata. |
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 il DATA. METHOD_INFORMATION. BytesNeeded membro nella struttura NDIS_OID_REQUEST alle dimensioni minime del buffer, in byte, necessarie. |
NDIS_STATUS_FAILURE |
La richiesta non è riuscita per altri motivi. |
Fabbisogno
Versione |
Supportato in NDIS 6.40 e versioni successive. |
Intestazione |
Ntddndis.h (include Ndis.h) |