NdisOpenProtocolConfiguration 函式 （ndis.h）
附註 NDIS 5。 x 已被取代，且已被 NDIS 6 取代。 x。 如需新的 NDIS 驅動程式開發，請參閱從 Windows Vista 開始網路驅動程式。 如需移植 NDIS 5 的相關信息。 x 驅動程式至 NDIS 6。 x，請參閱 將 NDIS 5.x 驅動程式移植到 NDIS 6.0。
NdisOpenProtocolConfiguration 會傳回登錄機碼的句柄，其中會儲存通訊協定驅動程式的每個配接器資訊。
語法
void NdisOpenProtocolConfiguration(
[out] PNDIS_STATUS Status,
[out] PNDIS_HANDLE ConfigurationHandle,
[in] PCNDIS_STRING ProtocolSection
);
參數
[out] Status
呼叫端提供的變數指標，該變數設定為NDIS_STATUS_SUCCESS或從此函式傳回時失敗狀態。
[out] ConfigurationHandle
呼叫端提供的變數指標，在此變數中，此函式會將句柄傳回給命名迷你埠驅動程式的登錄機碼，呼叫端稍後將系結至此驅動程式。 此機碼下的值專案包含通訊協定安裝的配接器特定資訊。
[in] ProtocolSection
呼叫端提供的NDIS_STRING型別指標，其中包含系統預設字元集中指定的計數位符串。 這個計算字串會命名 NDIS NIC 驅動程式，實際上是適配卡，登錄通訊協定區段中的每個配接器參數機碼應該開啟。 針對 Windows 2000 和更新版本的通訊協定，此計算字串包含 Unicode 字元。 也就是說，針對 Windows 2000 和更新版本，NDIS 會將NDIS_STRING類型定義為 UNICODE_STRING 類型。
此指標是呼叫者 ProtocolBindAdapter 函式的 SystemSpecific1 輸入參數。
傳回值
沒有
言論
NdisOpenProtocolConfiguration 會傳回呼叫端後續可傳遞至 Ndis 的句柄。組態 函式，以擷取或儲存登錄中的資訊。
通訊協定驅動程式會呼叫 NdisOpenProtocolConfiguration，以取得後續要傳遞至其他 Ndis 的登錄機碼句柄。組態 函式，例如 NdisRead/WriteConfiguration 或 NdisOpenConfigurationKeyByName/Index，如果其安裝檔案將配接器特定組態資訊儲存在通訊協定設定其系結的登錄通訊協定區段中。
通訊協定可以呼叫 NdisOpenConfigurationKeyByName 或 NdisOpenConfigurationKeyByIndex，以開啟 NdisOpenProtocolConfiguration 傳回句柄之登錄機碼的任何子機碼。
Windows 2000 和更新版本的通訊協定會呼叫內核模式支援例程，以開啟自己的通訊協定特定登錄機碼。 如需這些支援例程的詳細資訊，請參閱 Kernel-Mode 支援例程 摘要和 Power Management 支援例程。
- 目標平臺：通用
- 版本：Windows Vista 中不支援 NDIS 6.0 驅動程式。 請改用 NdisOpenConfigurationEx。 支援 Windows Vista 和 Windows XP 中的 NDIS 5.1 驅動程式。
要求
| 要求 | 價值 |
|---|---|
| 標頭 | ndis.h （包括 Ndis.h） |
| 連結庫 | Ndis.lib |
| IRQL | PASSIVE_LEVEL |