NetConfigurationOpenSubConfiguration 関数 (netconfiguration.h)
指定したアダプター構成オブジェクトのサブ構成を開きます。
構文
NTSTATUS NetConfigurationOpenSubConfiguration(
[_In_] NETCONFIGURATION Configuration,
[_In_] PCUNICODE_STRING SubConfigurationName,
[_In_opt_] WDF_OBJECT_ATTRIBUTES *SubConfigurationAttributes,
[_Out_] NETCONFIGURATION *SubConfiguration
);
パラメーター
[_In_] Configuration
NetAdapterOpenConfiguration または NetConfigurationOpenSubConfigurationの前の呼び出しで開かれたアダプター構成オブジェクトへのハンドル。
[_In_] SubConfigurationName
開くサブ構成の名前を指定する文字列へのポインター。
[_In_opt_] SubConfigurationAttributes
新しい構成オブジェクトのドライバー指定の属性を含む WDF_OBJECT_ATTRIBUTES 構造体へのポインター。 このパラメーターは省略可能であり、WDF_NO_OBJECT_ATTRIBUTESできます。
[_Out_] SubConfiguration
新しいサブ構成オブジェクトへのハンドルを受け取る場所へのポインター。
戻り値
この関数は、操作が成功した場合にSTATUS_SUCCESSを返します。 それ以外の場合、この関数は適切な NTSTATUS エラー コードを返す可能性があります。
備考
クライアントが WDF_OBJECT_ATTRIBUTESを提供する場合は、ParentObject NULL 指定します。 既定では、サブ構成は既存のアダプター構成オブジェクトの親になります。
クライアント ドライバーは、サブ構成オブジェクトまたは親アダプター構成オブジェクト NetConfigurationClose を呼び出して、サブ構成を閉じます。
必要条件
| 要件 | 価値 |
|---|---|
| ターゲット プラットフォーム の | 万国 |
| 最小 KMDF バージョン | 1.21 |
| UMDF の最小バージョン を する | 2.33 |
| ヘッダー | netconfiguration.h (netadaptercx.h を含む) |
| ライブラリ | NetAdapterCxStub.lib |
| IRQL | PASSIVE_LEVEL |