Función SetupDiGetCustomDevicePropertyW (setupapi.h)

Artículo
11/20/2024

La función SetupDiGetCustomDeviceProperty recupera una propiedad de dispositivo personalizada especificada del Registro.

Sintaxis

WINSETUPAPI BOOL SetupDiGetCustomDevicePropertyW(
  [in]            HDEVINFO         DeviceInfoSet,
  [in]            PSP_DEVINFO_DATA DeviceInfoData,
  [in]            PCWSTR           CustomPropertyName,
  [in]            DWORD            Flags,
  [out, optional] PDWORD           PropertyRegDataType,
  [out]           PBYTE            PropertyBuffer,
  [in]            DWORD            PropertyBufferSize,
  [out, optional] PDWORD           RequiredSize
);

Parámetros

[in] DeviceInfoSet

Identificador de la conjunto de información del dispositivo que contiene un elemento de información del dispositivo que representa el dispositivo para el que se va a recuperar una propiedad de dispositivo personalizada.

[in] DeviceInfoData

Puntero a una estructura de SP_DEVINFO_DATA que especifica el elemento de información del dispositivo en DeviceInfoSet.

[in] CustomPropertyName

Nombre de valor del Registro que representa una propiedad personalizada.

[in] Flags

Valor de marca que indica cómo se debe devolver la información solicitada. La marca puede ser cero o una de las siguientes:

DICUSTOMDEVPROP_MERGE_MULTISZ

Si se establece, la función recupera los valores de propiedad específicos de la instancia de dispositivo y los valores de propiedad específicos del identificador de hardware, concatenados como una cadena con tipo REG_MULTI_SZ. (Para obtener más información, vea la sección comentarios de en esta página de referencia).

[out, optional] PropertyRegDataType

Puntero a una variable de tipo DWORD que recibe el tipo de datos de la propiedad recuperada. El tipo de datos se especifica como una de las constantes REG_ con prefijo que representa los tipos de datos del Registro. Este parámetro es opcional y se puede NULL.

[out] PropertyBuffer

Puntero a un búfer que recibe información de propiedad solicitada.

[in] PropertyBufferSize

Tamaño, en bytes, del búfer de PropertyBuffer .

[out, optional] RequiredSize

Puntero a una variable de tipo DWORD que recibe el tamaño del búfer, en bytes, necesario para recibir la información solicitada. Este parámetro es opcional y se puede NULL. Si se especifica este parámetro, SetupDiGetCustomDeviceProperty devuelve el tamaño necesario, independientemente de si el PropertyBuffer búfer es lo suficientemente grande como para recibir la información solicitada.

Valor devuelto

Si la operación se realiza correctamente, setupDiGetCustomDeviceProperty devuelve TRUE. De lo contrario, la función devuelve FALSE y el error registrado se puede recuperar con una llamada a GetLastError. Si el búfer PropertyBuffer de no es lo suficientemente grande como para recibir la información solicitada, SetupDiGetCustomDeviceProper ty devuelve false y una llamada posterior a GetLastError devolverá ERROR_INSUFFICIENT_BUFFER.

Observaciones

SetupDiGetCustomDeviceProperty recupera las propiedades del dispositivo asociadas a una sola instancia de dispositivo o con todos los dispositivos que coinciden con un determinado identificador de hardware. (Para obtener información sobre los identificadores de hardware, consulte cadenas de identificación de dispositivos).

Los proveedores pueden establecer propiedades para una instancia de dispositivo mediante directivas AddReg de INF en secciones INF DDInstall.HW y especificar la raíz del registro HKR de .

Solo el sistema puede establecer propiedades para identificadores de hardware. El sistema proporciona una propiedad "Icon" para algunos identificadores de hardware.

La función comprueba primero si la propiedad especificada existe para la instancia de dispositivo especificada. Si es así, se devuelve el valor de la propiedad. Si no es así, la función comprueba si la propiedad existe para todos los dispositivos que coinciden con el identificador de hardware de la instancia de dispositivo especificada. Si es así, se devuelve el valor de la propiedad. Si DICUSTOMDEVPROP_MERGE_MULTISZ se establece en Marcas, la función devuelve los valores de propiedad asociados a la instancia del dispositivo y al identificador de hardware, si ambos existen.

Nota

El encabezado setupapi.h define SetupDiGetCustomDeviceProperty como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito	Valor
cliente mínimo admitido	Disponible en Windows XP y versiones posteriores de Windows.
de la plataforma de destino de	Escritorio
encabezado de	setupapi.h (incluya Setupapi.h)
biblioteca de	Setupapi.lib
DLL de	Setupapi.dll