Funzione VideoPortGetDeviceData (video.h)
La funzione VideoPortGetDeviceData recupera le informazioni di configurazione rilevate dal sistema da .. \Machine\Hardware\Description albero nel Registro di sistema. Queste informazioni sono specifiche del bus o specifiche dell'adattatore e archiviate nel Registro di sistema dal caricatore di sistema o da HAL.
Sintassi
VIDEOPORT_DEPRECATED VIDEOPORT_API VP_STATUS VideoPortGetDeviceData(
PVOID HwDeviceExtension,
VIDEO_DEVICE_DATA_TYPE DeviceDataType,
PMINIPORT_QUERY_DEVICE_ROUTINE CallbackRoutine,
PVOID Context
);
Parametri
HwDeviceExtension
Puntatore all'estensione del dispositivo del driver miniport.
DeviceDataType
Specifica il tipo di dati richiesto come valore VIDEO_DEVICE_DATA_TYPE, in genere uno di VpBusData, VpControllerData o VpMonitorData.
I valori VpControllerData e VpMonitorData sono rilevanti solo nelle piattaforme conformi ad ARC. I driver miniport delle schede video di tipo x86 in genere specificano VpBusData, in particolare per le schede sugli autobus EISA. Il valore VpMachineData è riservato per l'uso futuro.
CallbackRoutine
Puntatore a una funzione HwVidQueryDeviceCallback fornita dal driver da chiamare con le informazioni richieste.
Context
Puntatore a un parametro di contesto determinato dal chiamante da passare al CallbackRoutine. In genere punta al buffer VIDEO_PORT_CONFIG_INFO .
Valore restituito
VideoPortGetDeviceData restituisce NO_ERROR se ha chiamato correttamente la funzione HwVidQueryDeviceCallback del driver miniport con informazioni di configurazione.
Commenti
VideoPortGetDeviceData non può essere chiamato dalle funzioni HwVidInterrupt o HwVidTimer o da VideoPortQueueDpc o da un callback a VideoPortSynchronizeExecution.
L'albero del Registro di sistema da cui VideoPortGetDeviceData recupera le informazioni di configurazione è volatile; ovvero, viene ricreato dal caricatore di sistema o HAL ogni volta che il sistema viene caricato. Poiché queste informazioni vengono raccolte e archiviate all'inizio del processo di avvio, le informazioni di configurazione relative al bus restituite da VideoPortGetBusData possono essere più complete.
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 |