共用方式為

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 支援例程 和 電源管理支援例程的摘要。

  • 目標平臺： 通用
  • 版本：Windows Vista 中不支援 NDIS 6.0 驅動程式。 請改用 NdisOpenConfigurationEx。 Windows Vista 和 Windows XP 中支援 NDIS 5.1 驅動程式。

規格需求

需求 值
標頭 ndis.h (包含 Ndis.h)
程式庫 Ndis.lib
IRQL PASSIVE_LEVEL

另請參閱