estructura de SP_CLASSINSTALL_HEADER (setupapi.h)

Artículo
03/01/2024

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.