Funzione VideoPortGetRegistryParameters (video.h)
La funzione di VideoPortGetRegistryParameters recupera le informazioni di configurazione specifiche del dispositivo nella chiave dell'adattatore all'avvio del Registro di sistema.
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 di valore da recuperare dal Registro di sistema. Per altre informazioni, vedere la sezione osservazioni.
IsParameterFileName
Se il valore è TRUE, il valore di dati restituito normalmente viene considerato come un nome file. In tal caso, viene restituito il contenuto memorizzato nel buffer del file 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 chiamato la funzione del driver miniport HwVidQueryNamedValueCallback; in caso contrario restituisce ERROR_INVALID_PARAMETER.
Osservazioni
non è possibile chiamare VideoPortGetRegistryParameters da un driver miniport HwVidInterrupt o funzioni HwVidTimer oppure da VideoPortQueueDpco da un callback a VideoPortSynchronizeExecution.
Per Windows XP e versioni successive del sistema operativo, il parametro ParameterName può contenere un percorso che fa esattamente riferimento a un nome di valore uno o più livelli al di sotto della chiave adapter. Ad esempio, la stringa "SubKey1\Value1" può essere usata per ottenere la voce di valore per il numero di valore Value1 nella sottochiave SubKey1.
La chiave del Registro di sistema da cui VideoPortGetRegistryParameters recupera informazioni di configurazione non può contenere informazioni sul driver di visualizzazione corrispondente, perché il driver miniport HwVidFindAdapter funzioni eseguite prima del caricamento di 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.
Fabbisogno
| 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 |