共用方式為

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 傳遞給 MiniportInitializeEx 之 MiniportAdapterHandle 參數的網路適配器句柄。

[in] BlockId

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

[in] Buffer

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

[in] Length

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

傳回值

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

傳回碼 Description
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 () 總線驅動程式支援的 GUID_VPCI_INTERFACE_STANDARD 介面公開。

在 Hyper-V 子數據分割的客體作業系統中執行的 VBD，可以透過對其實體裝置對象發出IRP_MN_QUERY_INTERFACE要求給其實體裝置物件， (PDO) ，以查詢GUID_VPCI_INTERFACE_STANDARD介面。 您必須從 IRQL = PASSIVE_LEVEL提出此要求。 在此要求中，驅動程式必須將 InterfaceType 參數設定為 GUID_VPCI_INTERFACE_STANDARD。

規格需求

需求 值
最低支援的用戶端 不支援，NDIS 6.30 和更新版本中支援。
最低支援的伺服器 Windows Server 2012
目標平台 Universal
標頭 ndis.h (包括 Ndis.h)
程式庫 Ndis.lib
IRQL <= APC_LEVEL

另請參閱

GUID_VPCI_INTERFACE_STANDARD

WriteVfConfigBlock