指定したレジストリ値に現在割り当てられているデータを取得し、フレームワークによって割り当てられたバッファーにデータを格納し、バッファーを表すフレームワーク メモリ オブジェクトを作成します。
構文
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 |
| ヘッダー | netconfiguration.h (netadaptercx.h を含む) |
| IRQL | PASSIVE_LEVEL |