OID_NIC_SWITCH_VF_PARAMETERS

發行項
03/13/2025

過度的驅動程式或使用者模式應用程式發出OID_NIC_SWITCH_VF_PARAMETERS的物件標識碼（OID）方法要求，以取得網路適配器上PCI Express （PCIe）虛擬函式（VF）的目前組態參數。只有透過 OID_NIC_SWITCH_ALLOCATE_VF OID 方法要求配置資源的 VF，才能透過 OID_NIC_SWITCH_VF_PARAMETERS 的 OID 方法要求來查詢。

NDIS 會處理迷你埠驅動程式OID_NIC_SWITCH_VF_PARAMETERS的 OID 方法要求。

提出 OID 方法要求時，NDIS_OID_REQUEST 結構的 InformationBuffer 成員包含 NDIS_NIC_SWITCH_VF_PARAMETERS 結構的指標。

言論

過度配置驅動程式或使用者模式應用程式會將 NDIS_NIC_SWITCH_VF_PARAMETERS 結構 VFId 成員設定為 VF 的識別符，以指定要查詢的 VF。過度裝載的驅動程式或應用程式會透過下列其中一種方式取得 VF 識別符：

藉由發出 OID_NIC_SWITCH_ENUM_VFS的 OID 方法要求。

如果成功完成此 OID 要求，過度配置驅動程式或使用者模式應用程式會收到網路適配器上配置的所有 VF 清單。清單中的每個元素都是一個 NDIS_NIC_SWITCH_VF_INFO 結構，其中包含由 VFId 成員指定的 VF 標識符。
藉由發出 OID_NIC_SWITCH_ALLOCATE_VF的 OID 方法要求。

如果成功完成此 OID 要求，過度配置驅動程式會在傳回 NDIS_NIC_SWITCH_VF_PARAMETERS 結構 VFId 成員中收到新建立 VF 的標識碼。

注意只有過度使用驅動程式才能以這種方式取得 VF 標識符。

從 OID 方法要求成功傳回之後，InformationBuffer 成員 NDIS_OID_REQUEST 結構包含 NDIS_NIC_SWITCH_VF_PARAMETERS 結構的指標。這個結構包含指定 VF 的組態參數。

傳回狀態代碼

NDIS 會處理迷你埠驅動程式OID_NIC_SWITCH_VF_PARAMETERS的 OID 方法要求，並針對 OID_NIC_SWITCH_VF_PARAMETERS 的 OID 方法要求傳回下列狀態代碼。

狀態代碼	描述
NDIS_STATUS_SUCCESS	要求成功完成。 InformationBuffer 成員指向 NDIS_NIC_SWITCH_VF_PARAMETERS 結構。
NDIS_STATUS_NOT_SUPPORTED	迷你埠驅動程式不支援單一根目錄 I/O 虛擬化（SR-IOV）介面，或未啟用使用介面。
NDIS_STATUS_INVALID_PARAMETER	NDIS_NIC_SWITCH_VF_PARAMETERS 結構的一或多個成員具有無效的值。
NDIS_STATUS_INVALID_LENGTH	信息緩衝區的長度小於sizeof（NDIS_NIC_SWITCH_VF_PARAMETERS）。 NDIS 會設定 DATA。METHOD_INFORMATION。BytesNeededNDIS_OID_REQUEST 結構中的成員，以所需的緩衝區大小下限。
NDIS_STATUS_INVALID_LENGTH	信息緩衝區太短。 NDIS 會設定 DATA。METHOD_INFORMATION。BytesNeededNDIS_OID_REQUEST 結構中的成員，以所需的緩衝區大小下限。
NDIS_STATUS_FAILURE	要求因其他原因而失敗。