次の方法で共有

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 以降では、VideoPortSetRegistryParameters は、ValueName パラメーターで渡された文字列が "DefaultSettings" で始まる場合にERROR_INVALID_PARAMETERを返します。(ピリオドは文字列の一部であることに注意してください)。 Windows 2000 より前のオペレーティング システムでは、ビデオ ミニポート ドライバーは、"DefaultSettings" で始まる値の名前を渡してモニターの既定の解像度を指定できますが、Windows 2000 以降ではその機能は必要ありません。

オペレーティング システムの任意のバージョンのチェック ビルドで、"DefaultSettings" で始まる値の名前が原因でアサーション エラーが発生します。

VideoPortSetRegistryParameters は、ミニポート ドライバーの HwVidInterrupt または HwVidTimer 関数、または VideoPortQueueDpc 、またはコールバックから VideoPortSynchronizeExecution 呼び出すことはできません。

必要条件

要件 価値
サポートされる最小クライアント Windows 2000 以降のバージョンの Windows オペレーティング システムで使用できます。
ターゲット プラットフォーム の デスクトップ
ヘッダー video.h (Video.h を含む)
ライブラリ Videoprt.lib
DLL Videoprt.sys
IRQL PASSIVE_LEVEL

関連項目

HwVidFindAdapter を する

HwVidInitialize の

VideoPortFlushRegistry

VideoPortGetRegistryParameters