PMINIPORT_GET_REGISTRY_ROUTINE video.h) (回呼函式

發行項
02/29/2024

HwVidQueryNamedValueCallback 會處理從登錄擷取的指定數據。

語法

PMINIPORT_GET_REGISTRY_ROUTINE PminiportGetRegistryRoutine;

VP_STATUS PminiportGetRegistryRoutine(
  PVOID HwDeviceExtension,
  PVOID Context,
  PWSTR ValueName,
  PVOID ValueData,
  ULONG ValueLength
)
{...}

參數

HwDeviceExtension

迷你埠驅動程式每個適配卡儲存區域的指標。如需詳細資訊，請參閱裝置擴充功能。

Context

指定為 VideoPortGetRegistryParameters 函式輸入之驅動程式決定內容的指標。

ValueName

NULL 終止 Unicode 字串的指標，命名專案。

ValueData

與 VideoPortGetRegistryParameters 所提供的 ValueName 相關聯的緩衝數據指標。

ValueLength

指定 ValueData 緩衝區的大小，以位元組為單位。

傳回值

HwVidQueryNamedValueCallback 會傳回作業的狀態。

備註

HwVidQueryNamedValueCallback 是選擇性的迷你埠驅動程式函式，傳入對 VideoPortGetRegistryParameters 的呼叫。

VideoPortGetRegistryParameters 會在收集登錄配接器機碼中指定 ValueName 的可用組態信息之後，呼叫 HwVidQueryNamedValueCallback。

HwVidFindAdapter 或 HwVidInitialize 可以使用驅動程式提供的 HwVidQueryNamedValueCallback 函式呼叫 VideoPortGetRegistryParameters、裝置延伸模組的指標，以及任何驅動程式提供的內容數據 (，可以是VIDEO_PORT_CONFIG_INFO緩衝區) ，以及命名要從登錄擷取值的 Unicode 字符串指標。

HwVidFindAdapter 或 HwVidInitialize 可以將 VideoPortGetRegistryParameters 的 IsFileNameParameter 自變數設定為 TRUE ，如果驅動程式提供的 Unicode 字符串是名為登錄專案，其值為檔名。針對此規格，傳回的數據會是具名檔案的內容。

當 VideoPortGetRegistryParameters 呼叫 HwVidQueryNamedValueCallback 函式時，它會處理任何可用的設定數據。例如， HwVidQueryNamedValueCallback 可能會使用擷取的數據來判斷迷你埠驅動程式的存取範圍，以及在將控制權傳回 HwVidFindAdapter 函式之前， ( (的任何) 、中斷向量或中斷 IRQL () VIDEO_PORT_CONFIG_INFO 等等，以及迷你埠驅動程式的裝置擴充功能。

HwVidInitialize 也可以呼叫 VideoPortGetRegistryParameters 並將 IsFileNameParameter 設定為 TRUE ，讓迷你埠驅動程式提供的 HwVidQueryNamedValueCallback 函式可以使用具名檔案的緩衝內容，在配接器上設定微碼。

傳回的 ValueData 位於堆疊上，因此可以在本機參考。 HwVidQueryNamedValueCallback 可以儲存部分或所有傳回的資訊，以供輸入 HwDeviceExtension 中的其他迷你埠驅動程式函式使用，或使用輸入內容作為可儲存數據的位置指標。

HwVidQueryNamedValueCallback 應設為可分頁。