Enumerazione dei commutatori di scheda di interfaccia di rete in una scheda di rete
Un driver o un'applicazione utente eccessiva può ottenere un elenco di tutti i commutatori di scheda di interfaccia di rete creati in una scheda di rete che supporta la virtualizzazione I/O radice singola (SR-IOV). Il driver o l'applicazione rilascia una richiesta di query OID (Object Identifier) di OID_NIC_SWITCH_ENUM_SWITCHES per ottenere questo elenco.
Una volta restituito correttamente da questa richiesta OID, il membro InformationBuffer della struttura NDIS_OID_REQUEST contiene un puntatore a un buffer contenente quanto segue:
Struttura NDIS_NIC_SWITCH_INFO_ARRAY che definisce il numero di elementi all'interno della matrice.
Matrice di strutture NDIS_NIC_SWITCH_INFO . Ognuna di queste strutture contiene le informazioni su un singolo commutatore di scheda di interfaccia di rete creato nella scheda di rete.
Nota Se la scheda di rete non dispone di commutatori di interfaccia di rete, il driver imposta il membro NumElements della struttura NDIS_NIC_SWITCH_INFO_ARRAY su zero e non vengono restituite strutture NDIS_NIC_SWITCH_INFO .
Nota A partire da Windows Server 2012, l'interfaccia SR-IOV supporta un solo commutatore di scheda di interfaccia di rete sulla scheda di rete. Questa opzione è nota come opzione di interfaccia di rete predefinita e fa riferimento all'identificatore NDIS_DEFAULT_SWITCH_ID.
NDIS gestisce la richiesta di OID_NIC_SWITCH_ENUM_SWITCHES per i driver miniport. NDIS restituisce le informazioni da una cache interna dei dati che gestisce dalle origini seguenti:
Impostazioni della parola chiave SR-IOV standardizzate nel Registro di sistema. Per altre informazioni su queste parole chiave, vedere Parole chiave INF standardizzate per SR-IOV.
Richieste OID di OID_NIC_SWITCH_CREATE_SWITCH e OID_NIC_SWITCH_PARAMETERS.
Nota NDIS fornisce anche l'enumerazione delle opzioni nel membro NicSwitchArray nelle strutture NDIS_BIND_PARAMETERS e NDIS_FILTER_ATTACH_PARAMETERS . Pertanto, i driver di protocollo e filtro eccessivamente non devono inviare OID_NIC_SWITCH_ENUM_SWITCHES richieste per ottenere queste informazioni.