次の方法で共有


NetConfigurationQueryBinary 関数 (netconfiguration.h)

指定されたレジストリ値に現在割り当てられているデータを取得し、フレームワークによって割り当てられたバッファーにデータを格納し、バッファーを表すフレームワーク メモリ オブジェクトを作成します。

構文

NTSTATUS NetConfigurationQueryBinary(
  [_In_]     NETCONFIGURATION      Configuration,
  [_In_]     PCUNICODE_STRING      ValueName,
  [_In_]     POOL_TYPE             PoolType,
  [_In_opt_] WDF_OBJECT_ATTRIBUTES *MemoryAttributes,
  [_Out_]    WDFMEMORY             *Memory
);

パラメーター

[_In_] Configuration

開かれたレジストリ キーを表す NETCONFIGURATION オブジェクトへのハンドル。

[_In_] ValueName

値名を含む UNICODE_STRING 構造体へのポインター。

[_In_] PoolType

データ バッファーに割り当てるメモリの種類を指定する、 POOL_TYPE型指定された値。

[_In_opt_] MemoryAttributes

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

[_Out_] Memory

新しいメモリ オブジェクトへのハンドルを受け取る場所へのポインター。 フレームワークは、このメモリ バッファーを割り当て、NETCONFIGURATION オブジェクトが閉じられたときに自動的に解放します。

戻り値

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

注釈

クライアント ドライバーは、 NetAdapterOpenConfiguration または NetConfigurationOpenSubConfiguration を呼び出して 、NETCONFIGURATION オブジェクトへのハンドルを取得します。

この関数によって割り当てられたメモリは、NETCONFIGURATION オブジェクトが閉じられると、フレームワークによって自動的に解放されます。

要件

要件
対象プラットフォーム ユニバーサル
最小 KMDF バージョン 1.21
最小 UMDF バージョン 2.33
Header netconfiguration.h (netadaptercx.h を含む)
IRQL PASSIVE_LEVEL