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

Vedi anche

HwVidFindAdapter

HwVidQueryDeviceCallback

VIDEO_PORT_CONFIG_INFO

VideoPortGetRegistryParameters