共用方式為


VideoPortSetRegistryParameters 函式 (video.h)

VideoPortSetRegistryParameters 函式會在登錄中的 配接器 機碼下寫入資訊。

語法

VIDEOPORT_API VP_STATUS VideoPortSetRegistryParameters(
       PVOID HwDeviceExtension,
  [in] PWSTR ValueName,
  [in] PVOID ValueData,
       ULONG ValueLength
);

參數

HwDeviceExtension

迷你埠驅動程式裝置延伸模組的指標。

[in] ValueName

緩衝區的指標,其中包含以 Null 終止的 Unicode 字串,這個字串會為在登錄中寫入數據的值專案命名。

[in] ValueData

緩衝區的指標,其中包含要針對 ValueName 專案寫入的值。

ValueLength

指定要寫入登錄之數據的大小,以位元組為單位。

傳回值

如果指定的數據成功寫入登錄,VideoPortSetRegistryParameters 會傳回NO_ERROR。 否則,它可以傳回ERROR_INVALID_PARAMETER。

言論

VideoPortSetRegistryParameters 登錄 配接器 機碼下搜尋 ValueName 參數中指定的值名稱。 如果搜尋的值名稱不存在,則此函式會自動建立它。 找到或建立值名稱時,ValueData 參數的內容會複製到值名稱。

針對 Windows XP 和更新版本的作系統版本,ValueName 參數中指定的值名稱不需要直接與 配接器 索引鍵相關聯。 相反地,ValueName 可以與包含 配接器 索引鍵的子機碼相關聯。 如果 ValueName 字串包含一或多個反斜杠,VideoPortSetRegistryParameters 搜尋或建立其值名稱位於字元串結尾的子機碼。

例如,如果 ValueName 設定為字串 “SubKey1\Value1”,則此函式會在登錄中 配接器 機碼底下搜尋 SubKey1,並在不存在時建立 SubKey1。 然後,函式會搜尋 Value1 值名稱,並視需要加以建立。 VideoPortSetRegistryParameters 然後將 ValueData 參數的內容複製到登錄。 ValueName 參數中指定的路徑可以參考 配接器 索引鍵下方任意數目的層級名稱,但此函式的行為基本上相同。 如果找不到子機碼或值名稱,則會自動建立。

在 Windows 2000 和更新版本中,如果傳入 ValueName 參數的字串以 “DefaultSettings” 開頭,VideoPortSetRegistryParameters 會傳回ERROR_INVALID_PARAMETER。(請注意,句號是字串的一部分)。 在 Windows 2000 之前的作系統中,視訊迷你埠驅動程式可以傳遞以 「DefaultSettings」 開頭的值名稱,以指定監視器的預設解析度,但 Windows 2000 和更新版本中不需要該功能。

在任何作系統版本的已檢查組建中,以 「DefaultSettings」 開頭的值名稱會導致判斷提示失敗。

VideoPortSetRegistryParameters 無法從迷你埠驅動程式的 HwVidInterruptHwVidTimer 函式,或從 VideoPortQueueDpc呼叫,或從回呼呼叫至 VideoPortSynchronizeExecution

要求

要求 價值
最低支援的用戶端 適用於 Windows 2000 和更新版本的 Windows作系統。
目標平臺 桌面
標頭 video.h (include Video.h)
連結庫 Videoprt.lib
DLL Videoprt.sys
IRQL PASSIVE_LEVEL

另請參閱

HwVidFindAdapter

HwVidInitialize

VideoPortFlushRegistry

VideoPortGetRegistryParameters