共用方式為


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 無法從迷你埠驅動程式的 HwVidInterruptHwVidTimer 函式,或從 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

另請參閱

HwVidFindAdapter

HwVidInitialize

HwVidQueryDeviceCallback

HwVidQueryNamedValueCallback

VIDEO_PORT_CONFIG_INFO

VideoPortFlushRegistry

VideoPortGetDeviceData

VideoPortSetRegistryParameters