funzione CM_Get_Class_PropertyW (cfgmgr32.h)

La funzione CM_Get_Class_Property recupera una proprietà del dispositivo impostata per una classe di interfaccia dispositivo o una classe di installazione del dispositivo.

Sintassi

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
);

Parametri

[in] ClassGUID

Puntatore al GUID che identifica la classe di configurazione dell'interfacciadel dispositivo o la classe di installazione del dispositivo per cui recuperare una proprietà del dispositivo impostata per la classe del dispositivo. Per informazioni sulla specifica del tipo di classe, vedere il parametro ulFlags .

[in] PropertyKey

Puntatore a una struttura DEVPROPKEY che rappresenta la chiave della proprietà del dispositivo della proprietà della classe di dispositivo richiesta.

[out] PropertyType

Puntatore a una variabile tipizzata DEVPROPTYPE che riceve l'identificatore property-data-type della proprietà della classe di dispositivo richiesta, in cui l'identificatore property-data-type è l'identificatore OR bit per bit tra un identificatore di tipo dati di base e, se il tipo di dati di base viene modificato, un modificatore di tipo property-data-type.

[out] PropertyBuffer

Puntatore a un buffer che riceve la proprietà della classe di dispositivo richiesta. CM_Get_Class_Property recupera il valore della proprietà richiesto solo se il buffer è abbastanza grande per contenere tutti i dati del valore della proprietà. Il puntatore può essere NULL.

[in, out] PropertyBufferSize

Dimensioni, in byte, del buffer PropertyBuffer . Se il parametro PropertyBuffer è impostato su NULL, *PropertyBufferSize deve essere impostato su zero. Come output, se il buffer non è abbastanza grande per contenere tutti i dati del valore della proprietà, CM_Get_Class_Property restituisce le dimensioni dei dati, in byte, in *PropertyBufferSize.

[in] ulFlags

Flag delle proprietà di classe:

CM_CLASS_PROPERTY_INSTALLER

ClassGUID specifica una classe di installazione del dispositivo. Non combinare con CM_CLASS_PROPERTY_INTERFACE.

CM_CLASS_PROPERTY_INTERFACE

ClassGUID specifica una classe di interfaccia del dispositivo. Non combinare con CM_CLASS_PROPERTY_INSTALLER.

Valore restituito

Se l'operazione ha esito positivo, la funzione restituisce CR_SUCCESS. In caso contrario, restituisce uno dei codici di errore con prefisso CR_ definiti in Cfgmgr32.h.

Commenti

CM_Get_Class_Property fa parte del modello di proprietà dispositivo unificato.

Requisiti

Vedi anche

SetupDiGetClassProperty