OID_NIC_SWITCH_ALLOCATE_VF
過度的驅動程式發出OID_NIC_SWITCH_ALLOCATE_VF的物件標識碼 （OID） 方法要求，以配置PCI Express （PCIe） 虛擬函式 （VF） 的資源。 VF 會在支援單一根目錄 I/O 虛擬化 （SR-IOV） 介面的網路適配器上公開。
過度配置驅動程式向網路適配器 PCIe 實體函式的迷你埠驅動程式發出這個 OID 方法要求。 支援單一根 I/O 虛擬化 （SR-IOV） 介面的 PF 迷你埠驅動程式需要此 OID 方法要求。
InformationBufferNDIS_OID_REQUEST 結構的成員包含 NDIS_NIC_SWITCH_VF_PARAMETERS 結構的指標。
言論
當驅動程式處理OID_NIC_SWITCH_ALLOCATE_VF的物件標識碼 （OID） 方法要求時，PF 迷你埠驅動程式會配置 VF 的軟體資源。 即使已為 VF 配置硬體資源，但在 PF 迷你埠驅動程序順利完成OID_NIC_SWITCH_ALLOCATE_VF之前，仍視為非作。
如需如何設定 VF 資源的詳細資訊，請參閱 設定虛擬函式的資源。
注意 過度驅動程式要求 VF 的資源配置之後，該驅動程式是唯一可以要求釋放相同 VF 資源的元件。 過度裝載的驅動程式必須發出 OID_NIC_SWITCH_FREE_VF 的 OID 集合要求，以釋放 VF 資源。 在過度配置驅動程式停止之前，它必須釋放驅動程式OID_NIC_SWITCH_ALLOCATE_VF要求所配置之每個 VF 的資源。
傳回狀態代碼
PF 迷你埠驅動程式會針對 OID_NIC_SWITCH_ALLOCATE_VF 的 OID 方法要求傳回下列其中一個狀態代碼。
| 狀態代碼 | 描述 |
|---|---|
NDIS_STATUS_SUCCESS |
OID 要求已順利完成。 |
NDIS_STATUS_NOT_SUPPORTED |
PF 迷你埠驅動程式不支援單一根目錄 I/O 虛擬化 （SR-IOV） 介面，或未啟用使用 介面。 |
NDIS_STATUS_INVALID_PARAMETER |
NDIS_NIC_SWITCH_VF_PARAMETERS 結構的一或多個成員具有無效的值。 |
NDIS_STATUS_INVALID_LENGTH |
信息緩衝區的長度小於sizeof（NDIS_NIC_SWITCH_VF_PARAMETERS）。 PF 迷你埠驅動程序必須設定 數據。METHOD_INFORMATION。BytesNeededNDIS_OID_REQUEST 結構中的成員，以所需的緩衝區大小下限。 |
NDIS_STATUS_FAILURE |
要求因其他原因而失敗。 |
要求
版本 |
NDIS 6.30 和更新版本支援。 |
頁眉 |
Ntddndis.h （包括 Ndis.h） |