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 (包含 Video.h)
程式庫 Videoprt.lib
DLL Videoprt.sys
IRQL PASSIVE_LEVEL

另請參閱

HwVidFindAdapter

HwVidInitialize

VideoPortFlushRegistry

VideoPortGetRegistryParameters