estructura de SP_CLASSINSTALL_HEADER (setupapi.h)
Un SP_CLASSINSTALL_HEADER es el primer miembro de cualquier estructura de parámetros de instalación de clase. Contiene el código de solicitud de instalación del dispositivo que define el formato del resto de la estructura de parámetros de instalación.
Sintaxis
typedef struct _SP_CLASSINSTALL_HEADER {
DWORD cbSize;
DI_FUNCTION InstallFunction;
} SP_CLASSINSTALL_HEADER, *PSP_CLASSINSTALL_HEADER;
Miembros
cbSize
Tamaño, en bytes, de la estructura SP_CLASSINSTALL_HEADER.
InstallFunction
Solicitud de instalación de dispositivos (código DIF) para la estructura de parámetros de instalación de clase.
Los códigos DIF tienen el formato DIF_XXX y se definen en Setupapi.h. Consulte Códigos de función de instalación de dispositivos para obtener una descripción completa de los códigos DIF.
Comentarios
Cuando un componente asigna una estructura de parámetros de instalación de clase, normalmente inicializa los campos de encabezado de la estructura. Este componente establece el miembro InstallFunction en el código DIF para la solicitud de instalación y establece cbSize en el tamaño de la estructura de SP_CLASSINSTALL_HEADER. Por ejemplo:
SP_REMOVEDEVICE_PARAMS RemoveDeviceParams;
RemoveDeviceParams.ClassInstallHeader.cbSize = sizeof(SP_CLASSINSTALL_HEADER);
RemoveDeviceParams.ClassInstallHeader.InstallFunction = DIF_REMOVE;
Un componente debe establecer el miembro InstallFunction antes de pasar una estructura de parámetros de instalación de clase a SetupDiSetClassInstallParams.
Sin embargo, un componente no tiene que establecer este campo al pasar parámetros de instalación de clase a SetupDiGetClassInstallParams. Esta función establece el miembro InstallFunction en la estructura que pasa al autor de la llamada. Establece InstallFunction en el código DIF_XXX para la solicitud de instalación de dispositivos actualmente activa.
Requisitos
| Requisito | Valor |
|---|---|
| Header | setupapi.h (incluya Setupapi.h) |