Registrierungsschlüsselobjekte
Der PortCls-Systemtreiber implementiert die IRegistryKey-Schnittstelle zugunsten von Miniporttreibern. Ein IRegistryKey-Objekt stellt einen Registrierungsschlüssel dar. Miniporttreiber verwenden Registrierungsschlüsselobjekte, um die folgenden Schritte auszuführen:
Erstellen und Löschen von Registrierungsschlüsseln
Auflisten von Registrierungsschlüsseln
Abfragen und Festlegen von Registrierungsschlüsseln
Beim Abfragen eines Registrierungsschlüsselobjekts nach Informationen zu einem Registrierungseintrag unter dem angegebenen Schlüssel kann die Abfrage die Informationen in einem von drei Formaten ausgeben, von denen jedes eine andere Schlüssel-Abfrage-Struktur verwendet. Die folgende Tabelle zeigt die KEY_INFORMATION_CLASS Enumerationswerte, die angeben, welche der drei Schlüsselabfragestrukturen von der Abfrage ausgegeben wird.
| KEY_INFORMATION_CLASS Wert | Key-Query-Struktur |
|---|---|
KeyBasicInformation |
|
KeyFullInformation |
|
KeyNodeInformation |
Um einen vorhandenen Registrierungsschlüssel zu öffnen oder einen neuen Registrierungsschlüssel zu erstellen, kann ein Adaptertreiber die PcNewRegistryKey-Funktion aufrufen, und ein Miniporttreiber kann die IPort::NewRegistryKey-Methode des Porttreibers aufrufen. Die beiden Aufrufe sind ähnlich, mit dem Unterschied, dass die PcNewRegistryKey-Funktion zwei zusätzliche Parameter erfordert: DeviceObject und SubDevice. Weitere Informationen finden Sie unter PcNewRegistryKey.
Wenn ein Miniporttreiber ein neues IRegistryKey-Objekt erstellt, öffnet das Objekt entweder einen vorhandenen Unterschlüssel oder erstellt einen neuen Registrierungsunterschlüssel, sofern keins vorhanden ist. In beiden Fällen speichert das Registrierungsschlüsselobjekt das Handle für den Schlüssel. Wenn dieses Objekt später freigegeben wird und die Verweisanzahl auf null verringert wird, schließt das Objekt automatisch sein Handle mit dem Schlüssel.
Die IRegistryKey-Schnittstelle unterstützt die folgenden Methoden:
IRegistryKey::EnumerateValueKey