VideoPortSetRegistryParameters 関数 (video.h)
VideoPortSetRegistryParameters 関数は、レジストリのアダプター キーの下に情報を書き込みます。
構文
VIDEOPORT_API VP_STATUS VideoPortSetRegistryParameters(
PVOID HwDeviceExtension,
[in] PWSTR ValueName,
[in] PVOID ValueData,
ULONG ValueLength
);
パラメーター
HwDeviceExtension
ミニポート ドライバーのデバイス拡張機能へのポインター。
[in] ValueName
データがレジストリに書き込まれる値エントリに名前を付ける、null で終わる Unicode 文字列を含むバッファーへのポインター。
[in] ValueData
ValueName エントリに書き込まれる値を含むバッファーへのポインター。
ValueLength
レジストリに書き込むデータのサイズをバイト単位で指定します。
戻り値
VideoPortSetRegistryParameters は、指定されたデータがレジストリに正常に書き込まれた場合にNO_ERRORを返します。 それ以外の場合は、ERROR_INVALID_PARAMETERを返すことができます。
注釈
VideoPortSetRegistryParameters は、レジストリの アダプター キーの下で 、ValueName パラメーターで指定された値名を検索します。 検索される値名が存在しない場合、この関数によって自動的に作成されます。 値名が見つかるか作成されると、 ValueData パラメーターの内容が値名にコピーされます。
Windows XP 以降のオペレーティング システム バージョンの場合、 ValueName パラメーターで指定された値名を アダプター キーに直接関連付ける必要はありません。 代わりに、 ValueName を 、アダプター キーを含むパスを持つサブキーに関連付けることができます。 ValueName 文字列に 1 つ以上の円記号が含まれている場合、VideoPortSetRegistryParameters は文字列の末尾にある値の名前を持つサブキーを検索または作成します。
たとえば、ValueName が文字列 "SubKey1\Value1" に設定されている場合、この関数はレジストリ内のアダプター キーで SubKey1 を検索し、存在しない場合は SubKey1 を作成します。 次に、関数は Value1 値の名前を検索し、必要に応じて作成します。 次に、VideoPortSetRegistryParameters は ValueData パラメーターの内容をレジストリにコピーします。 ValueName パラメーターで指定されたパスは、アダプター キーの下にある任意の数のレベルの値名を参照できますが、この関数の動作は基本的に同じです。 サブキーまたは値の名前が見つからない場合は、自動的に作成されます。
Windows 2000 以降では、ValueName パラメーターに渡された文字列が "DefaultSettings" で始まる場合、VideoPortSetRegistryParameters はERROR_INVALID_PARAMETERを返します。(ピリオドは文字列の一部であることに注意してください)。 Windows 2000 より前のオペレーティング システムでは、ビデオ ミニポート ドライバーは、"DefaultSettings" で始まる値名を渡してモニターの既定の解像度を指定できますが、Windows 2000 以降ではその機能は必要ありません。
オペレーティング システムの任意のバージョンのチェック ビルドでは、"DefaultSettings" で始まる値名によってアサーション エラーが発生します。
VideoPortSetRegistryParameters は、ミニポート ドライバーの HwVidInterrupt 関数または HwVidTimer 関数、 VideoPortQueueDpc 関数、または VideoPortSynchronizeExecution へのコールバックから呼び出すことはできません。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 2000 以降のバージョンの Windows オペレーティング システムで使用できます。 |
| 対象プラットフォーム | デスクトップ |
| Header | video.h (Video.h を含む) |
| Library | Videoprt.lib |
| [DLL] | Videoprt.sys |
| IRQL | PASSIVE_LEVEL |