NdisOpenConfigurationEx 関数 (ndis.h)

[アーティクル]
08/07/2023

NDIS ドライバーは、 NdisOpenConfigurationEx 関数を呼び出して、レジストリ内の構成パラメーターへのアクセスを許可する構成ハンドルを取得します。

構文

NDIS_STATUS NdisOpenConfigurationEx(
  [in]  PNDIS_CONFIGURATION_OBJECT ConfigObject,
  [out] PNDIS_HANDLE               ConfigurationHandle
);

パラメーター

[in] ConfigObject

呼び出し元から提供され初期化されたへのポインター NDIS_CONFIGURATION_OBJECT 構造体。

[out] ConfigurationHandle

NdisOpenConfigurationEx がレジストリキーへのハンドルを返す、呼び出し元が指定した変数へのポインター。レジストリキーは、構成パラメーターを識別します。

戻り値

NdisOpenConfigurationEx は 、次のいずれかの状態値を返します。

リターンコード	説明
NDIS_STATUS_SUCCESS	NdisOpenConfigurationEx は、ドライバーの構成パラメーターが格納されているレジストリキーを正常に開きました。
NDIS_STATUS_RESOURCES	リソースが不足しているため、NdisOpenConfigurationEx が失敗しました。
NDIS_STATUS_FAILURE	上記の値が適用されない場合、NdisOpenConfigurationEx はNDIS_STATUS_FAILUREを返します。

注釈

NdisOpenConfigurationEx は 、 ConfigurationHandle パラメーターで構成ハンドルを返します。構成ハンドルは、構成パラメーターの場所を識別するレジストリキーに関連付けられます。呼び出し元は、レジストリ内の情報の読み取りまたは書き込みを行うために、構成ハンドルを他の NDIS 構成関数に渡すことができます。

構成情報にアクセスするには、次の関数で構成ハンドルを使用します。

NdisReadConfiguration

NdisWriteConfiguration

NdisOpenConfigurationKeyByName NdisOpenConfigurationKeyByIndex

構成ハンドルに関連付けられているレジストリデータの種類は、の NdisHandle メンバーで呼び出し元が NdisOpenConfigurationEx に渡すハンドルの種類によって異なります。ConfigObject パラメーターによって参照される構造体をNDIS_CONFIGURATION_OBJECTします。ハンドルは、ドライバーまたはドライバーのインスタンスに関連付けられているパラメーターを識別できます。

ドライバーが NdisHandle でハンドルを取得した場合は、 NdisMRegisterMiniportDriver 関数 、NdisOpenConfigurationEx は、ミニポートドライバーの構成パラメーターが格納されているレジストリの場所へのハンドルを提供します。ミニポートドライバーは、を呼び出すまで構成ハンドルを使用できます。 NdisMDeregisterMiniportDriver 関数。

ドライバーが MiniportInitializeEx 関数の MiniportAdapterHandle パラメーターから NdisHandle のハンドルを取得した場合、NdisOpenConfigurationEx は、ミニポートアダプターの構成パラメーターが格納されているレジストリの場所へのハンドルを提供します。ミニポートドライバーは、ソフトウェアによって構成され、ローカルで管理できるネットワークアドレス情報を取得する NdisReadNetworkAddress 関数に構成ハンドルを渡すことができます。ミニポートドライバーは、NDIS がミニポートアダプターを停止し、 MiniportHaltEx 関数が返されるまで、構成ハンドルを使用できます。

ドライバーが NdisHandle でハンドルを取得した場合は、 NdisRegisterProtocolDriver 関数 NdisOpenConfigurationEx は、プロトコルドライバーの構成パラメーターが格納されているレジストリの場所へのハンドルを提供します。プロトコルドライバーは、を呼び出すまで構成ハンドルを使用できます。 NdisDeregisterProtocolDriver 関数。

NdisHandle のハンドルが、ProtocolBindAdapterEx 関数の BindParameters パラメーターで NDIS が渡したNDIS_BIND_PARAMETERS構造体へのポインターである場合、NdisOpenConfigurationEx は、プロトコルバインドの構成パラメーターが格納されるレジストリの場所へのハンドルを提供します。プロトコルドライバーは、バインド操作が完了するまで構成ハンドルを使用できます。

ドライバーが NdisOpenAdapterEx 関数を呼び出して NdisHandle でハンドルを取得した場合、NdisOpenConfigurationEx は、プロトコルバインドの構成パラメーターが格納されているレジストリの場所へのハンドルを提供します。プロトコルドライバーは、 NdisCloseAdapterEx 関数を呼び出すまで、構成ハンドルを使用できます。

フィルタードライバーが NdisHandle でハンドルを取得した場合、 NdisFRegisterFilterDriver 関数 、NdisOpenConfigurationEx は、フィルタードライバーの構成パラメーターが格納されているレジストリの場所へのハンドルを提供します。フィルタードライバーは、を呼び出すまで構成ハンドルを使用できます。 NdisFDeregisterFilterDriver 関数。

フィルタードライバーが FilterAttach 関数の NdisFilterHandle パラメーターから NdisHandle のハンドルを取得した場合、NdisOpenConfigurationEx は、フィルターモジュール構成パラメーターが格納されているレジストリの場所へのハンドルを提供します。フィルタードライバーは、NDIS がフィルターモジュールをデタッチし、 FilterDetach 関数が返されるまで、構成ハンドルを使用できます。監視フィルタードライバーがの Flags メンバーにNDIS_CONFIG_FLAG_FILTER_INSTANCE_CONFIGURATION フラグを指定する場合 NDIS_CONFIGURATION_OBJECT 構造では、ドライバーは、同じミニポートアダプター経由で構成された複数のフィルターモジュールがある場合に、特定のフィルターモジュールのフィルターモジュール構成にアクセスできます。フィルタードライバーを変更するには、このフラグを使用しないでください。

ドライバーが構成情報へのアクセスを完了した後、ドライバーは NdisCloseConfiguration 関数を呼び出して、構成ハンドルと関連リソースを解放する必要があります。

メモこの関数が IRQL = PASSIVE_LEVELで実行されることを確認するために、ドライバーは NDIS 作業項目をスケジュールし、作業項目コールバックのコンテキストでこのおよび他の構成関数を呼び出すことができます。

要件

要件	値
サポートされている最小のクライアント	NDIS 6.0 以降でサポートされています。
対象プラットフォーム	ユニバーサル
Header	ndis.h (Ndis.h を含む)
Library	Ndis.lib
IRQL	PASSIVE_LEVEL
DDI コンプライアンス規則	Irql_Miscellaneous_Function(ndis)、 NdisOpenConfigurationEx(ndis)