Funzione VideoPortGetDeviceData (video.h)
La funzione di VideoPortGetDeviceData recupera le informazioni di configurazione rilevate dal sistema dal .. \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 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 richiesti come valore di VIDEO_DEVICE_DATA_TYPE, in genere uno dei VpBusData, VpControllerDatao VpMonitorData.
I valori VpControllerData e VpMonitorData sono rilevanti solo nelle piattaforme conformi ad ARC. I driver miniport di schede video di tipo x86 specificano in genere VpBusData, in particolare per gli adattatori sugli autobus EISA. Il valore VpMachineData è riservato per uso futuro.
CallbackRoutine
Puntatore a un driver fornito funzione HwVidQueryDeviceCallback da chiamare con le informazioni richieste.
Context
Puntatore a un parametro di contesto determinato dal chiamante da passare all'CallbackRoutine. In genere punta al buffer VIDEO_PORT_CONFIG_INFO.
Valore restituito
VideoPortGetDeviceData restituisce NO_ERROR se ha chiamato correttamente la funzione del driver miniport HwVidQueryDeviceCallback con informazioni di configurazione.
Osservazioni
VideoPortGetDeviceData non può essere chiamato da HwVidInterrupt o da funzioni HwVidTimer o da VideoPortQueueDpco 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.
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 |