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

関連項目

HwVidFindAdapter

HwVidInitialize

VideoPortFlushRegistry

VideoPortGetRegistryParameters