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 如果已成功收集要求的資訊,並呼叫 miniport 驅動程式的 HwVidQueryNamedValueCallback 函式,則會傳回NO_ERROR;否則會傳回ERROR_INVALID_PARAMETER。
備註
VideoPortGetRegistryParameters 無法從迷你埠驅動程式的 HwVidInterrupt 或 HwVidTimer 函式,或從 VideoPortQueueDpc 或從回呼呼叫 VideoPortSynchronizeExecution 呼叫。
針對 Windows XP 和更新版本的作業系統版本, ParameterName 參數可以包含一個路徑,該路徑會確切參考 配接器 密鑰下方的一或多個層級的值名稱。 例如,字串 「SubKey1\Value1」 可用來取得 SubKey1 子機碼下 Value1 值數位的值專案。
VideoPortGetRegistryParameters 擷取組態資訊的登錄機碼不能包含對應顯示驅動程式的任何資訊,因為迷你埠驅動程式 HwVidFindAdapter 函式會在載入任何顯示驅動程式之前執行。
迷你埠驅動程序不應該查詢儲存在 DefaultSettings 專案中的組態資訊,這在更新版本的操作系統中可能不受支援。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | 適用於 Windows 2000 和更新版本的 Windows 作業系統。 |
目標平台 | 桌面 |
標頭 | video.h (包含 Video.h) |
程式庫 | Videoprt.lib |
Dll | Videoprt.sys |
IRQL | PASSIVE_LEVEL |