NetDeviceOpenConfiguration 関数 (netdevice.h)

  • [アーティクル]

NetDeviceOpenConfiguration 関数は、net デバイスの構成データベースを開きます。

構文

NTSTATUS NetDeviceOpenConfiguration(
  [_In_]     WDFDEVICE             Device,
  [_In_opt_] WDF_OBJECT_ATTRIBUTES *ConfigurationAttributes,
  [_Out_]    NETCONFIGURATION      *Configuration
);

パラメーター

[_In_] Device

WdfDeviceCreate の呼び出しでクライアント ドライバーが以前に作成した WDFDEVICE オブジェクト。

[_In_opt_] ConfigurationAttributes

新しい構成オブジェクトのドライバー指定の属性を含む WDF_OBJECT_ATTRIBUTES 構造体へのポインター。 このパラメーターは省略可能であり、 WDF_NO_OBJECT_ATTRIBUTESできます。

[_Out_] Configuration

新しい NETCONFIGURATION オブジェクトを受け取る場所へのポインター。

戻り値

この関数は、操作が成功した場合STATUS_SUCCESSを返します。 それ以外の場合、この関数は適切な NTSTATUS エラー コードを返す可能性があります。

注釈

通常、クライアントはEVT_WDF_DRIVER_DEVICE_ADDコールバック関数からこの関数 を 呼び出します。

クライアントがWDF_OBJECT_ATTRIBUTESを提供する場合は、ParentObject に NULL を指定します。 デバイス構成オブジェクトは、デバイス オブジェクトに自動的に親されます。

その結果、デバイスが削除されると、WDF によって構成オブジェクトが自動的に削除されます。 ただし、クライアントは WdfObjectDelete を呼び出すことによって、構成オブジェクトを手動で削除できます(通常は 、EVT_WDF_OBJECT_CONTEXT_CLEANUP コールバック関数から)。

要件

要件 値
対象プラットフォーム ユニバーサル
最小 KMDF バージョン 1.27
Header netdevice.h (netadaptercx.h を含む)
Library netadaptercxstub.lib
IRQL PASSIVE_LEVEL

こちらもご覧ください

構成情報へのアクセス