DIF_ADDPROPERTYPAGE_ADVANCED
Una solicitud de DIF_ADDPROPERTYPAGE_ADVANCED permite que un instalador proporcione una o varias páginas de propiedades personalizadas para un dispositivo.
Cuándo se envió
Cuando un usuario hace clic en las propiedades de un dispositivo en Administrador de dispositivos o en Panel de control.
Quién controla
Co-instalador de clase |
Puede controlar |
Instalador co-instalador del dispositivo |
Puede controlar |
Instalador de clase |
Puede controlar |
Entrada del instalador
DeviceInfoSet
Proporciona un identificador al conjunto de información del dispositivo que contiene el dispositivo.
DeviceInfoData
Opcionalmente, proporciona un puntero a una estructura de SP_DEVINFO_DATA que identifica el dispositivo en el conjunto de información del dispositivo. Si DeviceInfoSet es NULL, Windows solicita páginas de propiedades para la clase de instalación del dispositivo.
Parámetros de instalación de dispositivos
Los parámetros de instalación de dispositivos (SP_DEVINSTALL_PARAMS) están asociados a DeviceInfoData, si se especifican, o con DeviceInfoSet.
Parámetros de instalación de clases
Una estructura de SP_ADDPROPERTYPAGE_DATA está asociada a DeviceInfoData, si se especifica, o con DeviceInfoSet.
Salida del instalador
Parámetros de instalación de dispositivos
Un instalador puede modificar los parámetros de instalación del dispositivo.
Parámetros de instalación de clases
Un instalador puede modificar el SP_ADDPROPERTYPAGE_DATA para proporcionar páginas personalizadas.
Valor devuelto del instalador
Un co-instalador puede devolver NO_ERROR o un error win32. Un co-instalador no debe devolver ERROR_DI_POSTPROCESSING_REQUIRED para esta solicitud DIF.
Un instalador de clase devuelve NO_ERROR si proporciona correctamente páginas. De lo contrario, un instalador de clase devuelve ERROR_DI_DO_DEFAULT o un código de error win32.
Controlador de código DIF predeterminado
Ninguno
Operación del instalador
En respuesta a esta solicitud de DIF, un instalador puede proporcionar páginas de propiedades personalizadas. El control de esta solicitud DIF permite proporcionar páginas de propiedades desde un instalador de clase o coinstaladores y elimina la necesidad de un archivo DLL independiente que actúe como proveedor de páginas de propiedades.
Normalmente, un instalador controla esta solicitud de DIF para agregar una nueva página de propiedades específica del dispositivo o específica de la clase de instalación. Un instalador también puede reemplazar la página de propiedades del controlador proporcionada por el sistema, la página de propiedades de recursos o la página de propiedades de energía de un dispositivo. Si un instalador reemplaza una página proporcionada por el sistema, el instalador debe establecer la marca adecuada en los parámetros de instalación del dispositivo:
DI_DRIVERPAGE_ADDED
El instalador proporcionó una página de propiedades del controlador.
DI_RESOURCEPAGE_ADDED
El instalador proporcionó una página de propiedades de recursos.
DI_FLAGSEX_POWERPAGE_ADDED
El instalador proporcionó una página de propiedades de energía.
Un instalador no puede reemplazar la página de propiedades generales proporcionada por el sistema.
Windows solo muestra una página de controlador, una página de recursos y una página de energía para un dispositivo. Un instalador no debe proporcionar una página del sistema de reemplazo si un instalador anterior ya proporcionó una página de ese tipo. Esta restricción no se aplica a las páginas de propiedades no proporcionadas por el sistema.
Un co-instalador debe agregar páginas personalizadas en su paso de preprocesamiento.
Si un instalador permite a un usuario establecer una propiedad que requiera que Windows quite y reinicie el dispositivo, el instalador debe establecer la marca DI_FLAGSEX_PROPCHANGE_PENDING en los parámetros de instalación del dispositivo desde su rutina DialogProc .
Para obtener más información sobre cómo proporcionar páginas de propiedades de dispositivo, vea Proporcionar páginas de propiedades del dispositivo.
Para obtener más información sobre los códigos DIF, consulte Control de códigos DIF.
Requisitos
Versión |
Compatible con Microsoft Windows 2000 y versiones posteriores de Windows. |
Encabezado |
Setupapi.h (incluir Setupapi.h) |