VideoPortGetRegistryParameters 関数 (video.h)
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 |