OID_NIC_SWITCH_ALLOCATE_VF
過度處理驅動程式會發出物件識別碼 (OID) 方法 OID_NIC_SWITCH_ALLOCATE_VF要求，以配置 PCI Express (PCIe (PCIe) Virtual Function (VF) 的資源。 VF 會在支援單一根目錄 I/O 虛擬化 (SR-IOV) 介面的網路介面卡上公開。
過度使用驅動程式向網路介面卡 PCIe 實體函式的迷你埠驅動程式發出此 OID 方法要求， (PF) 。 PF 迷你埠驅動程式需要此 OID 方法要求，這些驅動程式支援單一根目錄 I/O 虛擬化 (SR-IOV) 介面。
NDIS_OID_REQUEST結構的InformationBuffer成員包含NDIS_NIC_SWITCH_VF_PARAMETERS結構的指標。
備註
當驅動程式處理物件識別碼 (OID) 方法 OID_NIC_SWITCH_ALLOCATE_VF要求時，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 迷你埠驅動程式必須設定DATA。METHOD_INFORMATION。NDIS_OID_REQUEST 結構中的 BytesNeeded成員，到所需的緩衝區大小下限。 |
NDIS_STATUS_FAILURE |
要求因其他原因而失敗。 |
規格需求
版本 |
NDIS 6.30 和更新版本支援。 |
標頭 |
Ntddndis.h (包含 Ndis.h) |