Uzyskiwanie dostępu do ustawień niestandardowych

W systemie Windows Vista i nowszych wersjach systemu Windows ujednolicony model właściwości urządzenia obsługuje używanie kluczy właściwości do tworzenia i uzyskiwania dostępu do niestandardowych właściwości urządzenia. Aby uzyskać więcej informacji, zobacz Tworzenie niestandardowych właściwości urządzenia.

W systemach Windows Server 2003, Windows XP i Windows 2000 można utworzyć niestandardowe wartości wpisu rejestru w ramach kluczy rejestru dostarczonych przez system dla składnika powiązanego z urządzeniem. Poniższa lista zawiera funkcję SetupAPI, którą należy wywołać dla każdego typu składnika urządzenia, aby otworzyć odpowiedni klucz rejestru dostarczony przez system. Po otwarciu klucza rejestru zdefiniowanego przez system aplikacje i instalatory mogą wywoływać funkcje rejestru oparte na systemie Windows w celu zmodyfikowania niestandardowych wartości wpisu rejestru w ramach otwartego klucza rejestru.

• Niestandardowa wartość wpisu rejestru dla właściwości sprzętowej wystąpienia urządzenia powinna znajdować się w kluczu rejestru sprzętu tego wystąpienia urządzenia. Wywołaj SetupDiOpenDevRegKey i podaj DIREG_DEV w parametrze flagi , aby pobrać uchwyt do klucza sprzętowego wystąpienia urządzenia. Niestandardowe wartości wpisu rejestru ustawione w kluczu rejestru sprzętowego dla wystąpienia urządzenia można pobrać, wywołując funkcję SetupDiGetCustomDeviceProperty.

• Niestandardowa wartość wpisu w rejestrze dla właściwości oprogramowania powinna znajdować się w kluczu rejestru oprogramowania wystąpienia urządzenia. Wywołaj SetupDiOpenDevRegKey i podaj DIREG_DRV w parametrze Flags w celu pobrania uchwytu klucza rejestru oprogramowania wystąpienia urządzenia.

• Wartość wpisu rejestru niestandardowego dla właściwości klasy konfiguracji urządzenia powinna znajdować się w kluczu rejestru klasy konfiguracji urządzenia. Wywołaj SetupDiOpenClassRegKeyEx i podaj DIOCR_INSTALLER w parametrze Flags, aby uzyskać uchwyt do klucza rejestru dla klasy konfiguracji urządzenia.

• Niestandardowa wartość wpisu rejestru dla właściwości klasy interfejsu urządzenia powinna być umieszczona pod kluczem rejestru klasy interfejsu urządzenia. Wywołaj SetupDiOpenClassRegKeyEx i podaj DIOCR_INTERFACE w parametrze Flags oznaczonym jako , aby uzyskać uchwyt do klucza rejestru dla klasy interfejsu urządzenia.

• Wartość niestandardowego wpisu rejestru dla właściwości interfejsu urządzenia powinna być umieszczona pod kluczem rejestru interfejsu urządzenia. Wywołaj SetupDiOpenDeviceInterfaceRegKey, aby pobrać uchwyt do klucza rejestru dla klasy interfejsu urządzenia.

Po pobraniu dojścia do klucza rejestru, użyj tego dojścia w wywołaniu RegQueryValueEx lub RegSetValueEx, aby pobrać lub ustawić niestandardową wartość wpisu rejestru odpowiadającą niestandardowej właściwości urządzenia.

Wywołaj funkcję RegCloseKey, aby zamknąć klucz rejestru po tym, jak dostęp do tego klucza nie jest już wymagany.