функция CM_Get_Device_Interface_PropertyW (cfgmgr32.h)

Функция CM_Get_Device_Interface_Property извлекает свойство устройства, заданное для интерфейса устройства.

Синтаксис

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

Параметры

[in] pszDeviceInterface

Указатель на строку, определяющую экземпляр интерфейса устройства, из которого извлекается свойство.

[in] PropertyKey

Указатель на структуру DEVPROPKEY , представляющую ключ свойства интерфейса устройства извлекаемого свойства интерфейса устройства.

[out] PropertyType

Указатель на переменную типа DEVPROPTYPE, которая получает идентификатор типа property-data-type запрошенного свойства интерфейса устройства. Идентификатор property-data-type представляет собой побитовое ЗНАЧЕНИЕ ИЛИ между идентификатором базового типа данных и модификатором property-data-type, если тип базовых данных изменен.

[out] PropertyBuffer

Указатель на буфер, получающий запрошенное свойство интерфейса устройства. CM_Get_Device_Interface_Property извлекает запрошенное свойство, только если буфер достаточно велик для хранения всех данных значения свойства. Указатель может иметь значение NULL.

[in, out] PropertyBufferSize

Размер буфера PropertyBuffer (в байтах). Если свойство PropertyBuffer имеет значение NULL, параметру *PropertyBufferSize необходимо задать нулевое значение. В качестве выходных данных, если буфер недостаточно велик для хранения всех данных значения свойства, CM_Get_Device_Interface_Property возвращает размер данных в байтах в *PropertyBufferSize.

[in] ulFlags

Зарезервировано. Необходимо задать нулевое значение.

Возвращаемое значение

Если операция выполнена успешно, функция возвращает CR_SUCCESS. В противном случае возвращается один из кодов ошибок с CR_ префиксами, определенных в Cfgmgr32.h.

Комментарии

CM_Get_Device_Interface_Property является частью единой модели свойств устройства.

Требования

См. также раздел

SetupDiGetDeviceInterfaceProperty