funzione CM_Get_Device_Interface_PropertyW (cfgmgr32.h)

  • Articolo

La funzione CM_Get_Device_Interface_Property recupera una proprietà del dispositivo impostata per un'interfaccia del dispositivo.

Sintassi

CMAPI CONFIGRET CM_Get_Device_Interface_PropertyW(
  [in]      LPCWSTR          pszDeviceInterface,
  [in]      const DEVPROPKEY *PropertyKey,
  [out]     DEVPROPTYPE      *PropertyType,
  [out]     PBYTE            PropertyBuffer,
  [in, out] PULONG           PropertyBufferSize,
  [in]      ULONG            ulFlags
);

Parametri

[in] pszDeviceInterface

Puntatore a una stringa che identifica l'istanza dell'interfaccia del dispositivo da cui recuperare la proprietà.

[in] PropertyKey

Puntatore a una struttura DEVPROPKEY che rappresenta la chiave della proprietà dell'interfaccia dispositivo della proprietà dell'interfaccia del dispositivo da recuperare.

[out] PropertyType

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

[out] PropertyBuffer

Puntatore a un buffer che riceve la proprietà dell'interfaccia del dispositivo richiesta. CM_Get_Device_Interface_Property recupera la proprietà richiesta 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 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_Device_Interface_Property restituisce le dimensioni dei dati, in byte, in *PropertyBufferSize.

[in] ulFlags

Riservato. Deve essere impostato su zero.

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_Device_Interface_Property fa parte del modello di proprietà dispositivo unificato.

Requisiti

Requisito Valore
Client minimo supportato Disponibile in Microsoft Windows Vista e versioni successive di Windows.
Piattaforma di destinazione Universale
Intestazione cfgmgr32.h (include Cfgmgr32.h)
Libreria Cfgmgr32.lib

Vedi anche

SetupDiGetDeviceInterfaceProperty