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
Header netconfiguration.h (netadaptercx.h を含む)
Library NetAdapterCxStub.lib
IRQL PASSIVE_LEVEL

こちらもご覧ください

NetAdapterOpenConfiguration

NetConfigurationOpenSubConfiguration