Registrieren von Hardwareinformationen
Zum Anzeigen nützlicher Informationen für den Benutzer und zur Unterstützung beim Debuggen muss ein Anzeige-Miniporttreiber bestimmte Hardwareinformationen in der Registrierung festlegen. Ein Display-Miniporttreiber muss einen Chiptyp, einen DAC-Typ (Digital-Analog-Konverter), eine Arbeitsspeichergröße (des Adapters) und eine Zeichenfolge zum Identifizieren des Adapters festlegen. Diese Informationen werden von der Anwendung Anzeigen in Systemsteuerung angezeigt. In der Regel legt der Treiber diese Informationen in seiner DxgkDdiAddDevice-Funktion fest.
Um diese Informationen festzulegen, muss der Treiber:
Ruft die IoOpenDeviceRegistryKey-Funktion auf, um ein Handle für einen Softwareschlüssel zum Speichern treiberspezifischer Informationen zu öffnen und abzurufen. In diesem Aufruf gibt der Treiber das flag PLUGPLAY_REGKEY_DRIVER im DevInstKeyType-Parameter und den wert KEY_SET_VALUE, KEY_WRITE oder KEY_ALL_ACCESS im DesiredAccess-Parameter an.
Ruft die ZwSetValueKey-Funktion mehrmals auf, um jeden Typ von Hardwareinformationen festzulegen. Bei jedem Aufruf gibt der Treiber im KeyHandle-Parameter das Softwareschlüsselhandle an, das von IoOpenDeviceRegistryKey abgerufen wurde.
Die folgende Tabelle beschreibt die Informationen, die der Treiber registrieren muss, und enthält Details zu den Parametern ValueName und Data von ZwSetValueKey:
Informationen für die Eingabe ValueName-Parameter Data-Parameter Chiptyp
HardwareInformation.ChipType
Null-terminierte Zeichenfolge, die den Chipnamen enthält
DAC-Typ
HardwareInformation.DacType
Null-beendete Zeichenfolge, die den DAC-Namen oder -Bezeichner (ID) enthält
Arbeitsspeichergröße
HardwareInformation.MemorySize
ULONG, das die Menge des Videospeichers auf dem Adapter in Megabyte enthält
Adapter-ID
HardwareInformation.AdapterString
Null-beendete Zeichenfolge, die den Namen des Adapters enthält
BIOS
HardwareInformation.BiosString
Null-beendete Zeichenfolge, die Informationen zum BIOS enthält