VideoPortGetDeviceData, fonction (video.h)

La fonction VideoPortGetDeviceData récupère les informations de configuration détectées par le système à partir du .. \Machine\Hardware\Description tree in the Registry. Ces informations sont spécifiques au bus ou à l’adaptateur et sont stockées dans le Registre par le chargeur système ou hal.

Syntaxe

VIDEOPORT_DEPRECATED VIDEOPORT_API VP_STATUS VideoPortGetDeviceData(
  PVOID                          HwDeviceExtension,
  VIDEO_DEVICE_DATA_TYPE         DeviceDataType,
  PMINIPORT_QUERY_DEVICE_ROUTINE CallbackRoutine,
  PVOID                          Context
);

Paramètres

HwDeviceExtension

Pointeur vers l’extension de périphérique du pilote miniport.

DeviceDataType

Spécifie le type de données demandées en tant que valeur VIDEO_DEVICE_DATA_TYPE, généralement vpBusData, VpControllerData ou VpMonitorData.

Les valeurs VpControllerData et VpMonitorData sont pertinentes uniquement sur les plateformes conformes à ARC. Les pilotes miniport de cartes vidéo de type x86 spécifient généralement VpBusData, en particulier pour les adaptateurs sur les bus EISA. La valeur VpMachineData est réservée pour une utilisation ultérieure.

CallbackRoutine

Pointeur vers une fonction HwVidQueryDeviceCallback fournie par le pilote à appeler avec les informations demandées.

Context

Pointeur vers un paramètre de contexte déterminé par l’appelant à passer à CallbackRoutine. Il pointe généralement vers la mémoire tampon VIDEO_PORT_CONFIG_INFO .

Valeur retournée

VideoPortGetDeviceData retourne NO_ERROR s’il a correctement appelé la fonction HwVidQueryDeviceCallback du pilote miniport avec des informations de configuration.

Remarques

VideoPortGetDeviceData ne peut pas être appelé à partir des fonctions HwVidInterrupt ou HwVidTimer d’un pilote miniport, ou à partir de VideoPortQueueDpc ou d’un rappel à VideoPortSynchronizeExecution.

L’arborescence du Registre à partir de laquelle VideoPortGetDeviceData récupère les informations de configuration est volatile ; autrement dit, il est recréé par le chargeur système ou HAL chaque fois que le système est chargé. Étant donné que ces informations sont collectées et stockées au début du processus de démarrage, les informations de configuration relatives au bus retournées par VideoPortGetBusData peuvent être plus complètes.

Configuration requise

Voir aussi

HwVidFindAdapter

HwVidQueryDeviceCallback

VIDEO_PORT_CONFIG_INFO

VideoPortGetRegistryParameters