CM_Get_Class_PropertyW-Funktion (cfgmgr32.h)

Die CM_Get_Class_Property-Funktion ruft eine Geräteeigenschaft ab, die für eine Geräteschnittstellenklasse oder Geräteeinrichtungsklasse festgelegt ist.

Syntax

CMAPI CONFIGRET CM_Get_Class_PropertyW(
  [in]      LPCGUID          ClassGUID,
  [in]      const DEVPROPKEY *PropertyKey,
  [out]     DEVPROPTYPE      *PropertyType,
  [out]     PBYTE            PropertyBuffer,
  [in, out] PULONG           PropertyBufferSize,
  [in]      ULONG            ulFlags
);

Parameter

[in] ClassGUID

Zeiger auf die GUID, die die Geräteschnittstellenklasse oder Gerätesetupklasse identifiziert, für die eine für die Geräteklasse festgelegte Geräteeigenschaft abgerufen werden soll. Informationen zum Angeben des Klassentyps finden Sie im UlFlags-Parameter .

[in] PropertyKey

Zeiger auf eine DEVPROPKEY-Struktur , die den Geräteeigenschaftsschlüssel der angeforderten Geräteklasseneigenschaft darstellt.

[out] PropertyType

Zeiger auf eine DEVPROPTYPE-typisierte Variable, die den Property-Data-Type-Bezeichner der angeforderten Geräteklasseneigenschaft empfängt, wobei der Property-Data-Type-Bezeichner der bitweise OR zwischen einem Basisdatentypbezeichner und, wenn der Basisdatentyp geändert wird, einem Eigenschaft-Datentyp-Modifizierer ist.

[out] PropertyBuffer

Zeiger auf einen Puffer, der die angeforderte Geräteklasseneigenschaft empfängt. CM_Get_Class_Property ruft den angeforderten Eigenschaftswert nur ab, wenn der Puffer groß genug ist, um alle Eigenschaftenwertdaten zu enthalten. Der Zeiger kann NULL sein.

[in, out] PropertyBufferSize

Die Größe des PropertyBuffer-Puffers in Bytes. Wenn der PropertyBuffer-Parameter auf NULL festgelegt ist, muss *PropertyBufferSize auf null festgelegt werden. Wenn der Puffer nicht groß genug ist, um alle Eigenschaftswertdaten aufzunehmen, gibt CM_Get_Class_Property als Ausgabe die Größe der Daten in Bytes in *PropertyBufferSize zurück.

[in] ulFlags

Klasseneigenschaftsflags:

CM_CLASS_PROPERTY_INSTALLER

ClassGUID gibt eine Gerätesetupklasse an. Nicht mit CM_CLASS_PROPERTY_INTERFACE kombinieren.

CM_CLASS_PROPERTY_INTERFACE

ClassGUID gibt eine Geräteschnittstellenklasse an. Nicht mit CM_CLASS_PROPERTY_INSTALLER kombinieren.

Rückgabewert

Wenn der Vorgang erfolgreich ist, gibt die Funktion CR_SUCCESS zurück. Andernfalls wird einer der in Cfgmgr32.h definierten Fehlercodes mit CR_ Präfix zurückgegeben.

Hinweise

CM_Get_Class_Property ist Teil des einheitlichen Geräteeigenschaftenmodells.

Anforderungen

Weitere Informationen

SetupDiGetClassProperty