OID_NIC_SWITCH_VF_PARAMETERS

發行項
06/15/2023

過度使用驅動程式或使用者模式應用程式發出物件識別碼， (OID) 方法要求OID_NIC_SWITCH_VF_PARAMETERS，以取得網路介面卡上 PCI Express (PCIe) Virtual Function (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 方法要求成功傳回之後，NDIS_OID_REQUEST結構的InformationBuffer成員會包含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。NDIS_OID_REQUEST 結構中的 BytesNeeded成員，到所需的緩衝區大小下限。
NDIS_STATUS_INVALID_LENGTH	資訊緩衝區太短。 NDIS 會設定DATA。METHOD_INFORMATION。NDIS_OID_REQUEST 結構中的 BytesNeeded成員，到所需的緩衝區大小下限。
NDIS_STATUS_FAILURE	要求因其他原因而失敗。