NdisOpenConfigurationEx 関数 (ndis.h)

[アーティクル]
02/07/2025

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 関数をします。

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

ドライバーが呼び出して、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 以降でサポートされています。
ターゲットプラットフォームの	万国
ヘッダー	ndis.h (Ndis.h を含む)
ライブラリ	Ndis.lib
IRQL	PASSIVE_LEVEL
DDI コンプライアンス規則をする	Irql_Miscellaneous_Function(ndis)、NdisOpenConfigurationEx(ndis)

次の方法で共有

NdisOpenConfigurationEx 関数 (ndis.h)

構文

パラメーター

戻り値

備考

必要条件

関連項目

フィードバック

その他のリソース