VideoPortGetDeviceData-Funktion (video.h)
Die VideoPortGetDeviceData-Funktion ruft vom System erkannte Konfigurationsinformationen aus der .. Struktur \Machine\Hardware\Description 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
Zeiger auf die Geräteerweiterung des Miniporttreibers.
DeviceDataType
Gibt den Typ der Daten an, die als VIDEO_DEVICE_DATA_TYPE-Wert angefordert werden, in der Regel einer von VpBusData, VpControllerData oder VpMonitorData.
Die Werte VpControllerData und VpMonitorData 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 CallbackRoutine übergeben werden soll. Er zeigt in der Regel auf den VIDEO_PORT_CONFIG_INFO Puffer.
Rückgabewert
VideoPortGetDeviceData gibt NO_ERROR zurück, wenn die HwVidQueryDeviceCallback-Funktion des Miniporttreibers erfolgreich mit Konfigurationsinformationen aufgerufen wurde.
Hinweise
VideoPortGetDeviceData kann nicht von den Funktionen HwVidInterrupt oder HwVidTimer eines Miniporttreibers oder von VideoPortQueueDpc oder von einem Rückruf zu VideoPortSynchronizeExecution aufgerufen werden.
Die Registrierungsstruktur, aus der VideoPortGetDeviceData Konfigurationsinformationen abruft, ist flüchtig. Das heißt, es wird vom Systemladeprogramm oder der HAL jedes Mal neu erstellt, wenn das System geladen wird. Da diese Informationen frühzeitig im Startvorgang gesammelt und gespeichert werden, können die von VideoPortGetBusData zurückgegebenen busrelativen Konfigurationsinformationen vollständiger sein.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Verfügbar in Windows 2000 und höheren Versionen der Windows-Betriebssysteme. |
| Zielplattform | Desktop |
| Kopfzeile | video.h (einschließen von Video.h) |
| Bibliothek | Videoprt.lib |
| DLL | Videoprt.sys |
| IRQL | PASSIVE_LEVEL |