OID_NIC_SWITCH_ALLOCATE_VF
Un driver overlying genera una richiesta di metodo OID (Object Identifier) di OID_NIC_SWITCH_ALLOCATE_VF per allocare le risorse per una funzione virtuale PCI Express (PCIe). Il VF viene esposto in una scheda di rete che supporta l'interfaccia di virtualizzazione I/O radice singola (SR-IOV).
I driver overlying rilasciano questa richiesta di metodo OID al driver miniport per la funzione fisica PCIe della scheda di rete(PF). Questa richiesta di metodo OID è necessaria per i driver miniport PF che supportano l'interfaccia di virtualizzazione I/O (SR-IOV) singola.
Il membro InformationBuffer della struttura NDIS_OID_REQUEST contiene un puntatore a una struttura NDIS_NIC_SWITCH_VF_PARAMETERS .
Commenti
Il driver miniport PF alloca le risorse software per un VF quando il driver gestisce una richiesta di metodo OID (Object Identifier) di OID_NIC_SWITCH_ALLOCATE_VF. Anche se le risorse hardware sono state allocate per un VF, viene considerato non funzionante fino al completamento dell'OID_NIC_SWITCH_ALLOCATE_VF del driver PF miniport.
Per altre informazioni su come allocare risorse VF, vedere Allocazione delle risorse per una funzione virtuale.
Nota Dopo che un driver overlying richiede l'allocazione delle risorse per un VF, tale driver è l'unico componente che può richiedere la liberazione delle risorse per lo stesso VF. Il driver overlying deve emettere una richiesta OID set di OID_NIC_SWITCH_FREE_VF per liberare le risorse VF. Prima che il driver overlying possa essere arrestato, deve liberare le risorse per ogni VF allocato dalla richiesta di OID_NIC_SWITCH_ALLOCATE_VF del driver.
Codici di stato restituiti
Il driver miniport PF restituisce uno dei codici di stato seguenti per la richiesta del metodo OID di OID_NIC_SWITCH_ALLOCATE_VF.
| Codice di stato | Descrizione |
|---|---|
NDIS_STATUS_SUCCESS |
La richiesta OID è stata completata correttamente. |
NDIS_STATUS_NOT_SUPPORTED |
Il driver miniport PF non supporta l'interfaccia I/O (SR-IOV) radice singola o non è abilitata per l'uso dell'interfaccia. |
NDIS_STATUS_INVALID_PARAMETER |
Uno o più membri della struttura NDIS_NIC_SWITCH_VF_PARAMETERS hanno valori non validi. |
NDIS_STATUS_INVALID_LENGTH |
La lunghezza del buffer informativo è minore di sizeof(NDIS_NIC_SWITCH_VF_PARAMETERS). Il driver miniport PF deve impostare i DATI. METHOD_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) |