Funzione VideoPortGetRegistryParameters (video.h)

Articolo
02/26/2024

La funzione VideoPortGetRegistryParameters recupera informazioni di configurazione specifiche del dispositivo nella chiave dell'adattatore nel Registro di sistema all'avvio.

Sintassi

VIDEOPORT_API VP_STATUS VideoPortGetRegistryParameters(
       PVOID                          HwDeviceExtension,
  [in] PWSTR                          ParameterName,
       UCHAR                          IsParameterFileName,
       PMINIPORT_GET_REGISTRY_ROUTINE GetRegistryRoutine,
       PVOID                          Context
);

Parametri

HwDeviceExtension

Puntatore all'estensione del dispositivo del driver miniport.

[in] ParameterName

Puntatore a una stringa Unicode con terminazione NULL che assegna un nome alla voce valore da recuperare dal Registro di sistema. Per altre informazioni, vedere la sezione Osservazioni .

IsParameterFileName

Se il valore è TRUE, il valore dei dati normalmente restituito viene considerato come nome file. In tal caso, il contenuto memorizzato nel buffer di tale file viene restituito anziché il parametro stesso.

GetRegistryRoutine

Puntatore alla funzione HwVidQueryNamedValueCallback del driver miniport.

Context

Puntatore a un parametro di contesto determinato dal chiamante da passare al callbackRoutine, in genere il buffer VIDEO_PORT_CONFIG_INFO .

Valore restituito

VideoPortGetRegistryParameters restituisce NO_ERROR se ha raccolto correttamente le informazioni richieste e ha chiamato la funzione HwVidQueryNamedValueCallback del driver miniport; in caso contrario, restituisce ERROR_INVALID_PARAMETER.

Commenti

Non è possibile chiamare VideoPortGetRegistryParameters da funzioni HwVidInterrupt o HwVidTimer o da VideoPortQueueDpc o da un callback a VideoPortSynchronizeExecution.

Per windows XP e versioni successive del sistema operativo, il parametro ParameterName può contenere un percorso che fa riferimento esattamente a un nome valore uno o più livelli sotto la chiave dell'adattatore . Ad esempio, la stringa "SubKey1\Value1" può essere usata per ottenere la voce del valore per il numero di valore Value1 nella sottochiave SubKey1.

La chiave del Registro di sistema da cui VideoPortGetRegistryParameters recupera le informazioni di configurazione non può contenere informazioni sul driver di visualizzazione corrispondente, perché le funzioni del driver miniport HwVidFindAdapter vengono eseguite prima che venga caricato qualsiasi driver di visualizzazione.

I driver Miniport non devono eseguire query sulle informazioni di configurazione archiviate nelle voci DefaultSettings , che potrebbero non essere supportate nelle versioni successive del sistema operativo.

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile in Windows 2000 e versioni successive dei sistemi operativi Windows.
Piattaforma di destinazione	Desktop
Intestazione	video.h (includere Video.h)
Libreria	Videoprt.lib
DLL	Videoprt.sys
IRQL	PASSIVE_LEVEL