Función SetupDiGetClassDevPropertySheetsW (setupapi.h)
La función SetupDiGetClassDevPropertySheets recupera los identificadores de las hojas de propiedades de un elemento de información de dispositivo o de la clase de configuración del dispositivo de un conjunto de información de dispositivo.
Sintaxis
WINSETUPAPI BOOL SetupDiGetClassDevPropertySheetsW(
[in] HDEVINFO DeviceInfoSet,
[in, optional] PSP_DEVINFO_DATA DeviceInfoData,
[in] LPPROPSHEETHEADERW PropertySheetHeader,
[in] DWORD PropertySheetHeaderPageListSize,
[out, optional] PDWORD RequiredSize,
[in] DWORD PropertySheetType
);
Parámetros
[in] DeviceInfoSet
Identificador del conjunto de información del dispositivo para el que se van a devolver identificadores de hoja de propiedades. Si DeviceInfoData no especifica un elemento de información del dispositivo en el conjunto de información del dispositivo, el conjunto de información del dispositivo debe tener una clase de configuración de dispositivo asociada.
[in, optional] DeviceInfoData
Puntero a una estructura de SP_DEVINFO_DATA que especifica un elemento de información del dispositivo en DeviceInfoSet.
Este parámetro es opcional y puede ser NULL. Si se especifica este parámetro, SetupDiGetClassDevPropertySheets recupera los identificadores de las hojas de propiedades asociadas al dispositivo especificado. Si este parámetro es NULL, SetupDiGetClassDevPropertySheets recupera los identificadores de las hojas de propiedades asociadas a la clase de configuración del dispositivo especificada en DeviceInfoSet.
[in] PropertySheetHeader
Puntero a una estructura PROPERTYSHEETHEADER. Consulte la sección Comentarios para obtener información sobre la matriz proporcionada por el autor de la llamada de los identificadores de hoja de propiedades asociados a esta estructura.
Para obtener más documentación sobre esta estructura y hojas de propiedades en general, consulte la Microsoft Windows SDK.
[in] PropertySheetHeaderPageListSize
Número máximo de identificadores que puede contener la matriz proporcionada por el autor de la llamada de los identificadores de hoja de propiedades.
[out, optional] RequiredSize
Puntero a una variable de tipo DWORD que recibe el número de hojas de propiedades asociadas al elemento de información de dispositivo especificado o a la clase de configuración del dispositivo del conjunto de información de dispositivo especificado. El puntero es opcional y puede ser NULL.
[in] PropertySheetType
Marca que indica uno de los siguientes tipos de hojas de propiedades.
Tipo de hoja de propiedades | Significado |
---|---|
DIGCDP_FLAG_ADVANCED | Hojas de propiedades avanzadas. |
DIGCDP_FLAG_BASIC | Hojas de propiedades básicas. Solo se admite en Microsoft Windows 95 y Windows 98. No use en Windows 2000 y versiones posteriores de Windows. |
DIGCDP_FLAG_REMOTE_ADVANCED | Hojas de propiedades avanzadas en un equipo remoto. |
Valor devuelto
La función devuelve TRUE si se ejecuta correctamente. De lo contrario, la función devuelve FALSE. Llame a GetLastError para obtener el código de error.
Comentarios
Una estructura PROPERTYSHEETHEADER contiene dos miembros asociados a una matriz proporcionada por el autor de la llamada que la función usa para devolver los identificadores de las hojas de propiedades. El miembro phpages es un puntero a una matriz proporcionada por el autor de la llamada de identificadores de hoja de propiedades y el valor de entrada del miembro nPages especifica el número de identificadores que ya están incluidos en la matriz de identificadores. La función agrega identificadores de hoja de propiedades a la matriz handle a partir del elemento de matriz cuyo índice de matriz es el valor de entrada de nPages. La función agrega identificadores a la matriz en orden consecutivo hasta que la matriz está llena o los identificadores de todas las páginas de la hoja de propiedades solicitadas se han agregado a la matriz. El número máximo de identificadores de hoja de propiedades que la función puede devolver es igual a (PropertySheetHeaderPageListSize - (valor de entrada de nPages)).
Si la matriz de identificadores es lo suficientemente grande como para contener los identificadores de todas las páginas de hoja de propiedades solicitadas, la función :
- Agrega los identificadores a la matriz de identificadores.
- Establece nPages en el número total de identificadores de la matriz.
- Establece RequiredSize en el número de identificadores que devuelve.
- Devuelve TRUE.
- Agrega tantos identificadores como la matriz puede contener.
- Establece nPages en PropertySheetHeaderPageListSize.
- Establece RequiredSize en el número total de páginas de hoja de propiedades solicitadas. El número de identificadores que no devuelve la función es igual a (RequiredSize - PropertySheetHeaderPageListSize : (valor de entrada de nPages)).
- Establece el código de error en ERROR_INSUFFICIENT_BUFFER.
- Devuelve FALSE.
Nota
El encabezado setupapi.h define SetupDiGetClassDevPropertySheets 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 neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.
Requisitos
Requisito | Value |
---|---|
Cliente mínimo compatible | Disponible en Microsoft Windows 2000 y versiones posteriores de Windows. |
Plataforma de destino | Escritorio |
Encabezado | setupapi.h (incluya Setupapi.h) |
Library | Setupapi.lib |
Consulte también
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: a lo largo de 2024, eliminaremos gradualmente los problemas de GitHub como mecanismo de comentarios para el contenido y lo reemplazaremos por un nuevo sistema de comentarios. Para obtener más información, consulte:Enviar y ver comentarios de