VideoPortGetRegistryParameters 関数 (video.h)

[アーティクル]
08/08/2023

VideoPortGetRegistryParameters 関数は、起動時にレジストリのアダプター キーの下にあるデバイス固有の構成情報を取得します。

構文

VIDEOPORT_API VP_STATUS VideoPortGetRegistryParameters(
       PVOID                          HwDeviceExtension,
  [in] PWSTR                          ParameterName,
       UCHAR                          IsParameterFileName,
       PMINIPORT_GET_REGISTRY_ROUTINE GetRegistryRoutine,
       PVOID                          Context
);

パラメーター

HwDeviceExtension

ミニポートドライバーのデバイス拡張機能へのポインター。

[in] ParameterName

レジストリから取得する値エントリに名前を付ける NULL で終わる Unicode 文字列へのポインター。詳細については、「解説」セクションを参照してください。

IsParameterFileName

値が TRUE の場合、通常返されるデータ値はファイル名として扱われます。その場合は、パラメーター自体ではなく、そのファイルのバッファー内の内容が返されます。

GetRegistryRoutine

ミニポートドライバーの HwVidQueryNamedValueCallback 関数へのポインター。

Context

CallbackRoutine (通常はVIDEO_PORT_CONFIG_INFO バッファー) に渡される呼び出し元によって決定されたコンテキストパラメーターへのポインター。

戻り値

VideoPortGetRegistryParameters は、要求された情報を正常に収集し、ミニポートドライバーの HwVidQueryNamedValueCallback 関数を呼び出した場合、NO_ERRORを返します。それ以外の場合は、ERROR_INVALID_PARAMETERを返します。

注釈

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

Windows XP 以降のオペレーティングシステムバージョンの場合、 ParameterName パラメーターには、 アダプター キーの下の 1 つ以上のレベルの値名を正確に参照するパスを含めることができます。たとえば、文字列 "SubKey1\Value1" を使用して、SubKey1 サブキーの Value1 値番号の値エントリを取得できます。

VideoPortGetRegistryParameters が構成情報を取得するレジストリキーには、対応するディスプレイドライバーに関する情報を含めることはできません。ミニポートドライバー HwVidFindAdapter 関数は、ディスプレイドライバーが読み込まれる前に実行されるためです。

ミニポートドライバーは 、DefaultSettings エントリに格納されている構成情報に対してクエリを実行しないでください。これは、新しいバージョンのオペレーティングシステムではサポートされていない可能性があります。

要件

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