共用方式為

NdisMWriteConfigBlock 函式 （ndis.h）

  • 發行項

PCI Express （PCIe） 虛擬函式 （VF） 的迷你埠驅動程式會呼叫 NdisMWriteConfigBlock 函式，將數據寫入 VF 組態區塊。 VF 組態區塊上的寫入作業是由網路適配器 PCIe 實體函式 （PF） 的迷你埠驅動程序處理。

注意NdisMWriteConfigBlock 只能由網路適配器 VF 的迷你埠驅動程式呼叫。
 

語法

NDIS_STATUS NdisMWriteConfigBlock(
  [in] NDIS_HANDLE NdisMiniportHandle,
  [in] ULONG       BlockId,
  [in] PVOID       Buffer,
  [in] ULONG       Length
);

參數

[in] NdisMiniportHandle

NDIS 傳遞至 MiniportAdapterHandleMiniportInitializeEx的網路適配器句柄。

[in] BlockId

ULONG 值，指定要寫入之組態區塊的標識碼。 此標識元專屬於獨立硬體廠商 （IHV），而且只能由網路適配器上 PF 和 VF 的迷你埠驅動程式使用。

[in] Buffer

呼叫端配置的緩衝區指標，其中包含要寫入的組態數據。

[in] Length

要寫入組態區塊的位元組數目。

傳回值

NdisMWriteConfigBlock 可以傳回下列其中一個狀態值。

傳回碼 描述
NDIS_STATUS_SUCCESS
 寫入作業成功完成。
NDIS_STATUS_FAILURE
 寫入作業失敗。

言論

VF 迷你埠驅動程式會呼叫 NdisMWriteConfigBlock，以由 PF 迷你埠驅動程式起始 VF 組態數據的反向通道寫入要求。 通知此要求之後，PF 驅動程式會將數據寫入指定的 VF 組態區塊。

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

注意 每個 VF 組態區塊中的數據只會由 PF 和 VF 迷你埠驅動程式使用。
 
如需單一根目錄 I/O 虛擬化 （SR-IOV） 介面內反向通道通訊的詳細資訊，請參閱 SR-IOV PF/VF Backchannel Communication。

與虛擬總線驅動程式的介面

如果獨立硬體廠商 （IHV） 在其 SR-IOV 驅動程式套件中提供虛擬總線驅動程式 （VBD），則其迷你埠驅動程式不得呼叫 NdisMWriteConfigBlock。 相反地，驅動程式必須透過私人通道與 VBD 介面，並要求 VBD 呼叫 WriteVfConfigBlock。 此函式會從基礎虛擬PCI （IMFI） 總線驅動程式支援的 GUID_VPCI_INTERFACE_STANDARD 介面公開。

在 Hyper-V 子分割的客體作系統中執行的 VBD，可以藉由向其實體裝置物件 （PDO） 發出 IRP_MN_QUERY_INTERFACE 要求，以查詢 GUID_VPCI_INTERFACE_STANDARD 介面。 必須從 IRQL = PASSIVE_LEVEL提出此要求。 在此要求中，驅動程式必須將 InterfaceType 參數設定為 GUID_VPCI_INTERFACE_STANDARD。

要求

要求 價值
最低支援的用戶端 不支援，在 NDIS 6.30 和更新版本中支援。
支援的最低伺服器 Windows Server 2012
目標平臺 普遍
標頭 ndis.h （包括 Ndis.h）
連結庫 Ndis.lib
IRQL <= APC_LEVEL

另請參閱

GUID_VPCI_INTERFACE_STANDARD

WriteVfConfigBlock