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 無法從迷你埠驅動程式的 HwVidInterrupt 或 HwVidTimer 函式，或從 VideoPortQueueDpc 或從回呼呼叫 VideoPortSynchronizeExecution 呼叫。

規格需求

需求 值
最低支援的用戶端 適用於 Windows 2000 和更新版本的 Windows 作業系統。
目標平台 桌面
標頭 video.h (包含 Video.h)
程式庫 Videoprt.lib
Dll Videoprt.sys
IRQL PASSIVE_LEVEL

另請參閱

HwVidFindAdapter

HwVidInitialize

VideoPortFlushRegistry

VideoPortGetRegistryParameters