PF 迷你埠驅動程式的「MiniportAddDevice」原則
本主題描述為PCI Express (PCIe) 實體函式 (PF) 迷你埠驅動程式撰寫 MiniportAddDevice 函式的指導方針。 PF 是支援單一根 I/O 虛擬化的網路適配器元件(SR-IOV)。
注意 這些指導方針僅適用於 PF 迷你埠驅動程式。 如需 PCIe 虛擬功能(VF)適配器的迷你埠驅動程式初始化指導方針,請參閱 初始化 VF 迷你埠驅動程式。
隨插即用 (PnP) 管理員會呼叫 NDIS AddDevice 函式,以建立網路適配器的功能裝置物件 (FDO)。 如果 PF 迷你埠驅動程式在呼叫 NdisMRegisterMiniportDriver時註冊了 MiniportAddDevice 進入點,NDIS 會呼叫驅動程式的 MiniportAddDevice 函式。
呼叫 MiniportAddDevice 時,PF 迷你埠驅動程式可以為 SR-IOV 和網路適配器 (NIC) 交換器配置額外的軟體資源。 一般而言,這些是必須在 NDIS 呼叫驅動程式的 MiniportInitializeEx 函式之前配置的資源。
驅動程式可以在呼叫 miniportAddDevice 的內容中執行下列動作:
PF 迷你埠驅動程式可以呼叫 NdisReadConfiguration,從登錄讀取 SR-IOV 和 NIC 交換器組態設定。 這些組態設定是透過標準化 SR-IOV 關鍵詞來定義。 如需這些關鍵詞的詳細資訊,請參閱 SR-IOV 的標準化 INF 關鍵詞。
根據這些組態設定,PF 迷你埠驅動程式會配置 SR-IOV 網路適配器的額外軟體資源。
注意 PCI 組態空間中實際配置硬體資源和啟用 SR-IOV,只能在呼叫 MiniportInitializeEx的內容內完成。 由於當呼叫 MiniportAddDevice 時,網路適配器的記憶體對應 I/O(MMIO)空間尚未初始化,因此迷你埠驅動程式不得在呼叫 MiniportInitializeEx 之前讀取或寫入該適配器。