OID_SRIOV_READ_VF_CONFIG_BLOCK
過度的驅動程式會發出OID_SRIOV_READ_VF_CONFIG_BLOCK的物件識別碼 （OID） 方法要求，以從指定的PCI Express （PCIe） 虛擬函式 （VF） 組態區塊讀取數據。
過度配置驅動程式向網路適配器 PCIe 實體函式的迷你埠驅動程式發出這個 OID 方法要求。 支援單一根 I/O 虛擬化 （SR-IOV） 介面的 PF 迷你埠驅動程式需要此 OID 方法要求。
InformationBufferNDIS_OID_REQUEST 結構的成員包含呼叫端配置緩衝區的指標。 此緩衝區的格式設定為包含下列專案：
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 迷你埠驅動程序必須確認 VFId 所指定的 VF，NDIS_SRIOV_READ_VF_CONFIG_BLOCK_PARAMETERS 結構的成員，具有先前已配置的資源。 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。BytesNeededNDIS_OID_REQUEST 結構中的成員，以所需的緩衝區大小下限。 |
NDIS_STATUS_FAILURE |
要求因其他原因而失敗。 |
要求
版本 |
NDIS 6.30 和更新版本支援。 |
頁眉 |
Ntddndis.h （包括 Ndis.h） |