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