VideoPortGetDeviceData-Funktion (video.h)
Die VideoPortGetDeviceData--Funktion ruft vom System erkannte Konfigurationsinformationen aus der ab. \Computer\Hardware\Beschreibung Struktur in der Registrierung. Diese Informationen sind busspezifisch oder adapterspezifisch und werden vom Systemladeprogramm oder der HAL in der Registrierung gespeichert.
Syntax
VIDEOPORT_DEPRECATED VIDEOPORT_API VP_STATUS VideoPortGetDeviceData(
PVOID HwDeviceExtension,
VIDEO_DEVICE_DATA_TYPE DeviceDataType,
PMINIPORT_QUERY_DEVICE_ROUTINE CallbackRoutine,
PVOID Context
);
Parameter
HwDeviceExtension
Zeigen Sie auf die Geräteerweiterung des Miniporttreibers.
DeviceDataType
Gibt den Typ der angeforderten Daten als VIDEO_DEVICE_DATA_TYPE Wert an, in der Regel einer von VpBusData-, VpControllerData-oder VpMonitorData.
Die VpControllerData- und VpMonitorData- Werte sind nur auf ARC-kompatiblen Plattformen relevant. Miniporttreiber von x86-Grafikkarten geben in der Regel VpBusData-an, insbesondere für Adapter auf EISA-Bussen. Der VpMachineData- Wert ist für die zukünftige Verwendung reserviert.
CallbackRoutine
Zeiger auf eine vom Treiber bereitgestellte HwVidQueryDeviceCallback- Funktion, die mit den angeforderten Informationen aufgerufen werden soll.
Context
Zeiger auf einen vom Aufrufer bestimmten Kontextparameter, der an die CallbackRoutine-übergeben werden soll. Er verweist in der Regel auf den VIDEO_PORT_CONFIG_INFO Puffer.
Rückgabewert
VideoPortGetDeviceData- gibt NO_ERROR zurück, wenn der Miniporttreiber HwVidQueryDeviceCallback Funktion mit Konfigurationsinformationen erfolgreich aufgerufen wurde.
Bemerkungen
VideoPortGetDeviceData- kann nicht von HwVidInterrupt-- oder HwVidTimer--Funktionen oder von VideoPortQueueDpcoder von einem Rückruf zu VideoPortSynchronizeExecutionaufgerufen werden.
Die Registrierungsstruktur, aus der VideoPortGetDeviceData Konfigurationsinformationen abruft, ist veränderliche; d. h., es wird jedes Mal, wenn das System geladen wird, vom Systemladeprogramm oder HAL neu erstellt. Da diese Informationen frühzeitig im Startvorgang gesammelt und gespeichert werden, können die busrelativen Konfigurationsinformationen, die von VideoPortGetBusData- zurückgegeben werden, vollständiger sein.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Verfügbar in Windows 2000 und höheren Versionen von Windows-Betriebssystemen. |
| Zielplattform- | Desktop |
| Header- | video.h (video.h einschließen) |
| Library | Videoprt.lib |
| DLL- | Videoprt.sys |
| IRQL- | PASSIVE_LEVEL |