Condividi tramite

Linee guida miniportInitializeEx per i driver MINIPORT PF

  • Articolo

Questo argomento descrive le linee guida per la scrittura di una funzione MiniportInitializeEx per il driver miniport della funzione fisica PCI Express (PCIe). Pf è un componente di una scheda di rete che supporta la virtualizzazione I/O radice singola (SR-IOV).

Nota Queste linee guida si applicano solo ai driver miniport PF. Per le linee guida di inizializzazione per il driver miniport di una funzione virtuale PCIe (VF) dell'adattatore, vedere Inizializzazione di un driver miniport VF.

Il driver miniport PF segue gli stessi passaggi di qualsiasi driver miniport NDIS quando la sua funzione MiniportInitializeEx . Per altre informazioni su questi passaggi, vedere Inizializzazione di un driver Miniport.

Oltre a questi passaggi, il driver miniport PF deve seguire questi passaggi aggiuntivi quando NDIS chiama la funzione MiniportInitializeEx del driver:

  1. Il driver miniport PF chiama la funzione NdisGetHypervisorInfo per verificare che sia in esecuzione nella partizione padre Hyper-V. Questa funzione restituisce una struttura NDIS_HYPERVISOR_INFO che definisce il tipo di partizione. Se il tipo di partizione viene segnalato come NdisHypervisorPartitionMsHvParent, il driver miniport è in esecuzione nella partizione padre Hyper-V collegata alla scheda PF.

    Nota Se il tipo di partizione viene segnalato come NdisHypervisorPartitionMsHvChild, il driver miniport è in esecuzione nella partizione figlio Hyper-V collegata a un VF nell'adattatore. In questo caso, il driver miniport non deve inizializzare come driver PF. Se possibile, il driver deve inizializzare come driver VF come descritto in Inizializzazione di un driver miniport VF.

  2. Il driver miniport PF deve leggere le parole chiave standard SR-IOV per determinare se SR-IOV è abilitato e ottenere le impostazioni di configurazione del commutatore di interfaccia di rete. Per altre informazioni su queste parole chiave, vedere Parole chiave INF standardizzate per SR-IOV.

    Nota Se il driver miniport PF ha registrato un punto di ingresso a una funzione MiniportSetOptions , il driver potrebbe avere ottenuto in precedenza queste impostazioni dal Registro di sistema quando NDIS denominato MiniportSetOptions.

  3. Se la scheda di rete supporta SR-IOV, la coda di macchine virtuali (VMQ) o RSS, il driver miniport deve determinare quale funzionalità abilitare nella scheda di rete. Per altre informazioni su come determinare questa operazione, vedere Gestione delle parole chiave SR-IOV, VMQ e RSS Standardized INF.

  4. Oltre alle funzionalità hardware RSS e VMQ (se supportato), il driver miniport deve segnalare il set completo di funzionalità hardware SR-IOV. Queste funzionalità devono essere annunciate indipendentemente dalle impostazioni della parola chiave standard SR-IOV nel Registro di sistema.

    Se SR-IOV è abilitato nella scheda di rete, il driver miniport deve anche segnalare le impostazioni SR-IOV attualmente attivate nella scheda.

    Per altre informazioni sulla creazione di report sulle funzionalità SR-IOV, vedere Determinazione delle funzionalità SR-IOV.

  5. Il driver miniport deve segnalare il set completo di funzionalità del commutatore della scheda di interfaccia di rete hardware. Queste funzionalità devono essere annunciate indipendentemente dalle impostazioni della parola chiave standard SR-IOV nel Registro di sistema.

    Se SR-IOV è abilitato nella scheda di rete, il driver miniport deve anche segnalare le impostazioni dell'opzione di interfaccia di interfaccia di rete attualmente attivabili nella scheda.

    Per altre informazioni sulla creazione di report sulle funzionalità del commutatore della scheda di interfaccia di rete, vedere Determinazione delle funzionalità del commutatore della scheda di interfaccia di rete.

  6. Il driver miniport deve segnalare il set completo di funzionalità di filtro hardware. Queste funzionalità devono essere annunciate indipendentemente dalle impostazioni della parola chiave standard SR-IOV nel Registro di sistema.

    Se SR-IOV è abilitato nella scheda di rete, il driver miniport deve anche segnalare le impostazioni di filtro di ricezione attualmente attivate nella scheda.

    Per altre informazioni sulla creazione di report sulle funzionalità di filtro della ricezione, vedere Determinazione delle funzionalità di filtro di ricezione.

  7. Se il driver miniport supporta la creazione di commutatori di interfaccia di rete statici, deve eseguire le operazioni seguenti nel contesto della chiamata a MiniportInitializeEx.

    • Il driver configura l'hardware dell'adattatore in base alle impostazioni della parola chiave standard dell'interfaccia di interfaccia di rete. In base a queste impostazioni, il driver alloca le risorse hardware e software necessarie per il commutatore della scheda di interfaccia di rete.

    • Il driver miniport chiama NdisMEnableVirtualization per abilitare SR-IOV e impostare il numero di VFS nella scheda di rete. Questa funzione configura la funzionalità estesa SR-IOV nello spazio di configurazione PCI dell'adattatore. Se questa funzione restituisce NDIS_STATUS_SUCCESS, SR-IOV è abilitata e le macchine virtuali vengono esposte sull'interfaccia PCIe.

    Per altre informazioni, vedere Creazione statica di un commutatore di interfaccia di rete.

    Nota Se il driver miniport supporta la creazione di commutatori di interfaccia di rete dinamica, crea l'opzione e abilita la virtualizzazione quando gestisce una richiesta di metodo OID (Object Identifier) di OID_NIC_SWITCH_CREATE_SWITCH. Per altre informazioni, vedere Creazione dinamica di un commutatore di interfaccia di rete.