構成情報へのアクセス

  • [アーティクル]

NetAdapterCx クラス拡張機能は、クライアント ドライバー レジストリ パラメーターへのアクセスを提供する関数のセットをサポートしています。

通常、クライアント ドライバーは、 EVT_WDF_DRIVER_DEVICE_ADD コールバック関数から構成情報を読み取ります。

NetAdapter オブジェクトの場合は、まず NetAdapterOpenConfiguration を呼び出して、構成オブジェクトへのハンドルを取得します。 その後、クエリを実行できます。

NETCONFIGURATION configuration;

status = NetAdapterOpenConfiguration(NetAdapter, 
                                     WDF_NO_OBJECT_ATTRIBUTES, 
                                     &configuration);
if (!NT_SUCCESS(status)) {
    return status;
}

status = NetConfigurationQueryUlong(configuration, 
                                    NET_CONFIGURATION_QUERY_ULONG_NO_FLAGS, 
                                    &SomeValue, 
                                    &myvalue);

NetConfigurationClose(configuration);

ネット デバイスの構成オブジェクトを開いてクエリを実行する方法は次のようになります。

status = NetDeviceOpenConfiguration(Device, 
                                    WDF_NO_OBJECT_ATTRIBUTES, 
                                    &configuration);
if(!NT_SUCCESS(status))
{
    return status;
}

WDFCOLLECTION myStrings;

DECLARE_CONST_UNICODE_STRING(myValueName, L"ExampleValueName");

status = NetConfigurationQueryMultiString(configuration,
                                          myValueName,
                                          WDF_NO_OBJECT_ATTRIBUTES,
                                          myStrings);

ULONG データ、文字列、複数文字列 (REG_MULTI_SZと同様)、バイナリ BLOB、およびソフトウェアで構成可能なネットワーク アドレスを照会するための NetConfiguration* 関数があります。