Condividi tramite


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)

Vedi anche


NDIS_MAKE_RID

OID_NIC_SWITCH_CREATE_SWITCH

OID_NIC_SWITCH_CREATE_VPORT

NDIS_NIC_SWITCH_VF_PARAMETERS

OID_NIC_SWITCH_FREE_VF