OID_NIC_SWITCH_ALLOCATE_VF
Un driver overlying rilascia una richiesta di metodo OID (Object Identifier) di OID_NIC_SWITCH_ALLOCATE_VF per allocare 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 eccessivamente 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 di I/O radice singola (SR-IOV).
Il membro InformationBuffer della struttura NDIS_OID_REQUEST contiene un puntatore a una struttura NDIS_NIC_SWITCH_VF_PARAMETERS.
Osservazioni
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 operativo fino a quando il driver miniport PF non completa correttamente il OID_NIC_SWITCH_ALLOCATE_VF.
Per altre informazioni su come allocare risorse VF, vedere Allocazione di 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 interrotto, 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 |
Richiesta OID completata. |
NDIS_STATUS_NOT_SUPPORTED |
Il driver miniport PF non supporta l'interfaccia di virtualizzazione I/O radice singola (SR-IOV) 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 delle informazioni è minore di sizeof(NDIS_NIC_SWITCH_VF_PARAMETERS). Il driver miniport PF deve impostare il DATA. METHOD_INFORMATION. BytesNeeded membro nella struttura NDIS_OID_REQUEST alle dimensioni minime del buffer necessarie. |
NDIS_STATUS_FAILURE |
La richiesta non è riuscita per altri motivi. |
Fabbisogno
Versione |
Supportato in NDIS 6.30 e versioni successive. |
Intestazione |
Ntddndis.h (include Ndis.h) |