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 オペレーティング システムで使用できます。 |
| ターゲット プラットフォーム の | デスクトップ |
| ヘッダー | video.h (Video.h を含む) |
| ライブラリ | Videoprt.lib |
| DLL | Videoprt.sys |
| IRQL | PASSIVE_LEVEL |
関連項目
HwVidFindAdapter を する
HwVidInitialize の
HwVidQueryDeviceCallback の
HwVidQueryNamedValueCallback の
VideoPortGetDeviceData の