共用方式為


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

呼叫端提供的變數指標,在此變數中,此函式會將呼叫的狀態傳回為下列其中一個值。

價值 意義
NDIS_STATUS_SUCCESS
ParameterValue 的緩衝區 包含傳回的組態資訊。
NDIS_STATUS_RESOURCES
NDIS 無法配置資源,通常是足夠的記憶體,無法傳回要求的資訊。
NDIS_STATUS_FAILURE
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
  • NdisProcessorX86
  • NdisProcessorAmd64
  • NdisProcessorIA64
  • NdisProcessorAlpha
只有在舊版 (NDIS 6.0) 驅動程式時,才能執行下列動作:
  • NdisProcessorMips
  • NdisProcessorPpc
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 緩衝區,並在關鍵詞 複製呼叫端提供的字串,並釋放它配置給此複本的記憶體,再將控制權傳回給呼叫端。 它配置給的記憶體當驅動程式使用 NdisCloseConfiguration 函式釋放 ConfigurationHandle 時,會釋放 NDIS_CONFIGURATION_PARAMETER 結構。 NdisReadConfiguration 呼叫端負責在 Keyword釋放緩衝字串。

請注意,NDIS 不會驗證驅動程式從登錄讀取的值。 因此,NdisReadConfiguration 的呼叫端不得對這類值進行任何假設,而且必須驗證從登錄讀取的每個值。 如果呼叫端判斷值超出界限,則應該改用預設值。

如需安裝和安裝檔案的詳細資訊,請參閱 裝置安裝概觀

要求

要求 價值
最低支援的用戶端 Windows Vista 中支援 NDIS 6.0 和 NDIS 5.1 驅動程式(請參閱 NdisReadConfiguration (NDIS 5.1) 。 支援 Windows XP 中的 NDIS 5.1 驅動程式(請參閱 NdisReadConfiguration (NDIS 5.1)。
目標平臺 普遍
標頭 ndis.h (包括 Ndis.h)
連結庫 Ndis.lib
IRQL PASSIVE_LEVEL
DDI 合規性規則 Irql_Miscellaneous_Function(ndis)

另請參閱

ANSI_STRING

NDIS_CONFIGURATION_PARAMETER

NDIS_PARAMETER_TYPE

NdisAnsiStringToUnicodeString

NdisCloseConfiguration

NdisFreeString

NdisInitAnsiString

NdisInitUnicodeString

NdisInitializeString

NdisOpenConfigurationEx

NdisOpenConfigurationKeyByIndex NdisOpenConfigurationKeyByName

NdisReadNetworkAddress

NdisUnicodeStringToAnsiString

NdisWriteConfiguration

UNICODE_STRING