NdisReadConfiguration 函式 (ndis.h)
NdisReadConfiguration 函式會從登錄傳回指定型別的具名專案值，並指定開啟登錄機碼的句柄。 必須根據本身和 NdisWriteConfiguration 函式，以序列方式叫用此函式。
語法
void NdisReadConfiguration(
[out] PNDIS_STATUS Status,
[out] PNDIS_CONFIGURATION_PARAMETER *ParameterValue,
[in] NDIS_HANDLE ConfigurationHandle,
[in] PNDIS_STRING Keyword,
[in] NDIS_PARAMETER_TYPE ParameterType
);
參數
[out] Status
呼叫端提供之變數的指標，此變數會傳回呼叫的狀態做為下列其中一個值。
| 值 | 意義 |
|---|---|
|
ParameterValue 上的緩衝區包含傳回的組態資訊。 |
|
NDIS 無法配置資源，通常是足夠的記憶體，以傳回要求的資訊。 |
|
在 ConfigurationHandle 所指定的已開啟登錄機碼下找不到所要求的資訊。 |
[out] ParameterValue
NDIS 提供指標給 的記憶體位置指標如果 NdisReadConfiguration 的呼叫成功，NDIS_CONFIGURATION_PARAMETER 結構。 NDIS 會為 配置記憶體 NDIS_CONFIGURATION_PARAMETER 結構。
[in] ConfigurationHandle
NdisOpenConfigurationEx 所傳回之登錄機碼的句柄， NdisOpenConfigurationKeyByIndex 或 NdisOpenConfigurationKeyByName 函式。
[in] Keyword
呼叫端提供的NDIS_STRING型別指標，描述系統預設字元集中的計數位符串，並指定要傳回值的開啟登錄機碼下的項目名稱。
或者，呼叫端提供的指標NDIS_STRING_CONSTANT指定下列其中一個預先定義的項目名稱，以及預先定義的傳回值：
| 預先定義的項目名稱 | 預先定義的傳回值 |
|---|---|
| ProcessorType |
|
| NdisVersion | 0xMMMMmmmm，其中 MMMM 是主要版本， 而mmmm 是次要版本號碼。 例如，0x00050000表示系統支援的最高 NDIS 版本是主要版本 5，次要版本 0。 |
[in] ParameterType
指定為其中一個 NDIS_PARAMETER_TYPE 列舉值的值專案型別。 Windows NT 和更新版本中會忽略此參數。
傳回值
無
備註
在 Windows 2000 和更新版本的組態登錄中，NDIS 關鍵詞 與 值專案名稱同義。 這類名稱是 Unicode 字元的計數序列，以 NULL 結尾。
每個 NDIS 驅動程式都可以在其 INF 檔案中使用 AddReg 指示詞，在登錄中自行設定組態資訊。 例如，通訊協定驅動程式可能會將自己的名稱儲存為具有預先格式化字串值的專案，這些值可以在呼叫中傳遞至 NdisRegisterProtocolDriver 函 式。 如需詳細資訊，請參閱 網路 INF 檔案中的 Add-registry-sections。
每個迷你埠驅動程式在登錄中也有相關聯的值專案。 任何特定迷你埠驅動程式的值項目本質上都可以依裝置而定。 例如，迷你埠驅動程式可能有例如 *FlowControl、*SpeedDuplex 和 *InterruptModeration 等關鍵詞。 與這類 NDIS 關鍵詞相關聯的值可以是整數 (ULONG 類型) 或字串 (NDIS_STRING 類型) 。 例如，已提及之 *FlowControl 專案的可能值集合可能是 NdisParameterInteger 值 0、1、2 或 3，或十六進位為 NdisParameterHexInteger 值的對等值。
NdisReadConfiguration 緩衝區，並在 Keyword 複製呼叫端提供的字串，並釋放它配置給此複本的記憶體，再將控制權傳回給呼叫端。 其配置給的記憶體 當 驅動程式使用 NdisCloseConfiguration 函式釋放 ConfigurationHandle 時，會釋放NDIS_CONFIGURATION_PARAMETER結構。 NdisReadConfiguration 的呼叫端負責在 Keyword 釋放緩衝字串。
請注意，NDIS 不會驗證驅動程式從登錄讀取的值。 因此，NdisReadConfiguration 的呼叫端不得對這類值進行任何假設，而且必須驗證從登錄讀取的每個值。 如果呼叫端判斷值超出界限，則應該改用預設值。
如需安裝和安裝檔案的詳細資訊，請參閱 裝置安裝概觀。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | 支援 NDIS 6.0 和 NDIS 5.1 驅動程式， (請參閱 Windows Vista 中的 NdisReadConfiguration (NDIS 5.1) ) 。 (支援 NDIS 5.1 驅動程式，請參閱 Windows XP 中的 NdisReadConfiguration (NDIS 5.1) ) 。 |
| 目標平台 | Universal |
| 標頭 | ndis.h (包含 Ndis.h) |
| 程式庫 | Ndis.lib |
| IRQL | PASSIVE_LEVEL |
| DDI 合規性規則 | Irql_Miscellaneous_Function (ndis) |