función CM_Get_Device_Interface_Property_KeysW (cfgmgr32.h)

  • Artículo

La función CM_Get_Device_Interface_Property_Keys recupera una matriz de claves de propiedad de dispositivo que representan las propiedades del dispositivo establecidas para una interfaz de dispositivo.

Sintaxis

CMAPI CONFIGRET CM_Get_Device_Interface_Property_KeysW(
  [in]            LPCWSTR    pszDeviceInterface,
  [out, optional] DEVPROPKEY *PropertyKeyArray,
  [in, out]       PULONG     PropertyKeyCount,
  [in]            ULONG      ulFlags
);

Parámetros

[in] pszDeviceInterface

Puntero a una cadena que identifica la instancia de la interfaz de dispositivo desde la que recuperar las claves de propiedad.

[out, optional] PropertyKeyArray

Puntero a un búfer que recibe una matriz de valores con tipo DEVPROPKEY, donde cada valor es una clave de propiedad de dispositivo que representa una propiedad de dispositivo que se establece para la interfaz del dispositivo. El puntero es opcional y puede ser NULL.

[in, out] PropertyKeyCount

Tamaño, en unidades con tipo DEVPROPKEY, del búfer PropertyKeyArray . Si PropertyKeyArray está establecido en NULL, *PropertyKeyCount debe establecerse en cero. Como salida, si PropertyKeyArray no es lo suficientemente grande como para contener todos los datos de clave de propiedad, CM_Get_Device_Interface_Property_Keys devuelve el recuento de las claves, en *PropertyKeyCount.

[in] ulFlags

Reservado. Debe establecerse en cero.

Valor devuelto

Si la operación se realiza correctamente, la función devuelve CR_SUCCESS. De lo contrario, devuelve uno de los códigos de error CR_ prefijo definidos en Cfgmgr32.h.

Comentarios

CM_Get_Device_Interface_Property_Keys forma parte del modelo de propiedades de dispositivo unificado.

Requisitos

Requisito Value
Cliente mínimo compatible Disponible en Microsoft Windows Vista y versiones posteriores de Windows.
Plataforma de destino Universal
Encabezado cfgmgr32.h (incluya Cfgmgr32.h)
Library Cfgmgr32.lib

Consulte también

SetupDiGetDeviceInterfacePropertyKeys