NetAdapterOpenConfiguration 関数 (netadapter.h)
NetAdapterOpenConfiguration 関数は、net アダプターの構成データベースを開きます。
構文
NTSTATUS NetAdapterOpenConfiguration(
[_In_] NETADAPTER Adapter,
[_In_opt_] WDF_OBJECT_ATTRIBUTES *ConfigurationAttributes,
[_Out_] NETCONFIGURATION *Configuration
);
パラメーター
[_In_] Adapter
NetAdapterCreateの前の呼び出しでクライアントが作成したネットワーク アダプター オブジェクト。
[_In_opt_] ConfigurationAttributes
新しい構成オブジェクトのドライバー指定の属性を含む WDF_OBJECT_ATTRIBUTES 構造体へのポインター。 このパラメーターは省略可能であり、WDF_NO_OBJECT_ATTRIBUTESできます。
[_Out_] Configuration
新しいアダプター構成オブジェクトへのハンドルを受け取る場所へのポインター。
戻り値
この関数は、操作が成功した場合にSTATUS_SUCCESSを返します。 それ以外の場合、この関数は適切な NTSTATUS エラー コードを返す可能性があります。
備考
通常、クライアントは EVT_WDF_DRIVER_DEVICE_ADD コールバック関数からこの関数を呼び出します。
クライアントが WDF_OBJECT_ATTRIBUTESを提供する場合は、ParentObject NULL 指定します。 アダプター構成オブジェクトは、アダプター オブジェクトに自動的に親されます。
その結果、WDF は、アダプターが削除されたときに構成オブジェクトを自動的に削除します。 ただし、通常、クライアントは WdfObjectDelete 呼び出すことによって、EVT_WDF_OBJECT_CONTEXT_CLEANUP コールバック関数から構成オブジェクトを手動で削除できます。
必要条件
| 要件 | 価値 |
|---|---|
| ターゲット プラットフォーム の | 万国 |
| 最小 KMDF バージョン | 1.21 |
| UMDF の最小バージョン を する | 2.33 |
| ヘッダー | netadapter.h (netadaptercx.h を含む) |
| ライブラリ | NetAdapterCxStub.lib |
| IRQL | PASSIVE_LEVEL |