NdisMConfigMSIXTableEntry 函式 (ndis.h)
NdisMConfigMSIXTableEntry 函式會針對裝置指派的 MSI-X 訊息執行 MSI-X 數據表項目的設定作業。
語法
NDIS_STATUS NdisMConfigMSIXTableEntry(
[in] NDIS_HANDLE NdisMiniportHandle,
[in] PNDIS_MSIX_CONFIG_PARAMETERS MSIXConfigParameters
);
參數
[in] NdisMiniportHandle
提供給的 NDIS 迷你埠配接器句柄 MiniportInitializeEx 函 式。
[in] MSIXConfigParameters
呼叫端配置的指標 NDIS_MSIX_CONFIG_PARAMETERS 結構，定義要求的組態作業，並指定該特定作業所需的參數。
傳回值
NdisMConfigMSIXTableEntry 會從基礎 PCI 總線驅動程式或下列其中一個狀態值傳回適當的失敗碼：
| 傳回碼 | Description |
|---|---|
|
MSI-X 數據表專案已成功重新設定。 |
|
NdisMConfigMSIXTableEntry 失敗，因為 中有一或多個成員 NDIS_MSIX_CONFIG_PARAMETERS 結構無效。 |
備註
支援 MSI-X 的 NDIS 迷你埠驅動程式會呼叫 NdisMConfigMSIXTableEntry 函式來遮罩、取消遮罩或將 MSI-X 數據表項目對應至裝置指派的 MSI-X 訊息。 支援 RSS 的迷你埠驅動程式會使用 NdisMConfigMSIXTableEntry 在運行時間變更 MSI-X 數據表專案的 CPU 親和性。
NdisMConfigMSIXTableEntry 是 包裝函式 GUID_MSIX_TABLE_CONFIG_INTERFACE 查詢。 Miniport 驅動程式可以在 NDIS 呼叫 MiniportInitializeEx 函式以及驅動程式從 MiniportHaltEx 函式傳回之前呼叫 NdisMConfigMSIXTableEntry。
迷你埠驅動程式可以設定 MSI-X 中斷資源的 CPU 親和性，讓裝置為每個 RSS 處理器至少有一個 MSI-X 訊息。 請注意，PCI 總線驅動程式一開始會將 n MSI-X 資料表項目對應 (其中 n 是 NIC 已向總線回報的 MSI-X 資料表項目數目，) 到修改資源中的前 n 個 MSI-X 訊息。 在 NDIS 呼叫 MiniportInitializeEx 之後，當迷你埠驅動程式變更特定 MSI-X 資料表專案的目標處理器時，驅動程式會呼叫 NdisMConfigMSIXTableEntry ，將該數據表專案對應至已經設定為所需處理器的 MSI-X 訊息。
針對 NdisMSIXTableConfigSetTableEntry 作業， NdisMConfigMSIXTableEntry 的呼叫端必須在 IRQL <= DISPATCH_LEVEL執行。
針對 NdisMSIXTableConfigMaskTableEntry 或 NdisMSIXTableConfigUnmaskTableEntry 作業， NdisMConfigMSIXTableEntry 的呼叫端可以在任何 IRQL 上執行。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | NDIS 6.1 和更新版本支援。 |
| 目標平台 | Universal |
| 標頭 | ndis.h (包含 Ndis.h) |
| 程式庫 | Ndis.lib |
| IRQL | 請參閱一節 |