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

Vedere anche

HwVidFindAdapter

HwVidQueryDeviceCallback

VIDEO_PORT_CONFIG_INFO

VideoPortGetRegistryParameters