OID_SRIOV_READ_VF_CONFIG_BLOCK

過度處理驅動程式會發出物件識別碼 (OID) 方法要求 OID_SRIOV_READ_VF_CONFIG_BLOCK，以從指定的 PCI Express (PCIe) Virtual Function (VF) 組態區塊讀取資料。

過度使用驅動程式向網路介面卡 PCIe 實體函式的迷你埠驅動程式發出此 OID 方法要求， (PF) 。 PF 迷你埠驅動程式需要此 OID 方法要求，這些驅動程式支援單一根目錄 I/O 虛擬化 (SR-IOV) 介面。

NDIS_OID_REQUEST結構的InformationBuffer成員包含呼叫端配置緩衝區的指標。此緩衝區的格式設定為包含下列專案：

包含位移的 NDIS_SRIOV_READ_VF_CONFIG_BLOCK_PARAMETERS 結構，以位元組為單位，從這個結構的開頭到緩衝區內的位置，其中包含從 VF 組態區塊讀取的資料。
要從指定的 VF 組態區塊讀取之資料的額外緩衝區空間。

備註

VF 組態區塊用於 PF 與 VF 迷你埠驅動程式之間的反向通道通訊。 IHV 可以定義迷你埠驅動程式的一或多個 VF 組態區塊。每個 VF 組態區塊都有 IHV 定義的格式、長度和區塊識別碼。

注意來自每個 VF 組態區塊的資料只會由 PF 和 VF 迷你埠驅動程式使用。

在發出OID_SRIOV_READ_VF_CONFIG_BLOCK的 OID 方法要求之前，過度處理驅動程式必須以下列方式設定 NDIS_SRIOV_READ_VF_CONFIG_BLOCK_PARAMETERS 結構的成員：

將 VFId 成員設定為要從中讀取資訊的 VF 識別碼。
將 BlockId 成員設定為要從中讀取資訊的 VF 組態區塊識別碼。
將 Length 成員設定為要從組態區塊讀取的位元組數目。
將 BufferOffset 成員設定為 InformationBuffer 成員所參考之緩衝區內 (位移) ，其中包含從指定的 VF 組態區塊讀取的資料。這個位移是以 NDIS_SRIOV_READ_VF_CONFIG_BLOCK_PARAMETERS 結構開頭的位元組單位來指定。

當它處理OID_SRIOV_READ_VF_CONFIG_BLOCK的 OID 方法要求時，PF 迷你埠驅動程式必須遵循下列指導方針：

PF 迷你埠驅動程式必須確認由 NDIS_SRIOV_READ_VF_CONFIG_BLOCK_PARAMETERS結構的VFId 成員指定的 VF，具有先前已配置的資源。 PF 迷你埠驅動程式會在 OID_NIC_SWITCH_ALLOCATE_VF 的 OID方法要求期間，為 VF 配置資源。如果尚未配置指定 VF 的資源，驅動程式必須失敗 OID 要求。
PF 迷你埠驅動程式必須確認NDIS_SRIOV_READ_VF_CONFIG_BLOCK_PARAMETERS結構的BlockId成員指定有效的 VF 設定區塊。如果沒有，驅動程式必須失敗 OID 要求。

如需單一根目錄 I/O 虛擬化 (SR-IOV) 介面內後端通道通訊的詳細資訊，請參閱 SR-IOV PF/VF Backchannel Communication。

PF 迷你埠驅動程式會針對OID_SRIOV_READ_VF_CONFIG_BLOCK的方法要求傳回下列其中一個狀態碼。

狀態碼	描述
NDIS_STATUS_SUCCESS	OID 要求已順利完成。
NDIS_STATUS_NOT_SUPPORTED	迷你埠驅動程式不支援單一根目錄 I/O 虛擬化 (SR-IOV) 介面，或未啟用該介面。
NDIS_STATUS_INVALID_PARAMETER	NDIS_SRIOV_READ_VF_CONFIG_BLOCK_PARAMETERS結構的一或多個成員具有不正確值。
NDIS_STATUS_INVALID_LENGTH	資訊緩衝區太短。迷你埠驅動程式必須設定DATA。METHOD_INFORMATION。NDIS_OID_REQUEST 結構中的 BytesNeeded成員，到所需的緩衝區大小下限。
NDIS_STATUS_FAILURE	要求因其他原因而失敗。

版本	NDIS 6.30 和更新版本支援。
標頭	Ntddndis.h (包含 Ndis.h)