Condividi tramite


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)

Vedere anche


NDIS_MAKE_RID

OID_NIC_SWITCH_CREATE_SWITCH

OID_NIC_SWITCH_CREATE_VPORT

NDIS_NIC_SWITCH_VF_PARAMETERS

OID_NIC_SWITCH_FREE_VF