Funzione VideoPortGetRegistryParameters (video.h)
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 |