Compartir a través de


estructura de SP_SELECTDEVICE_PARAMS_A (setupapi.h)

Una estructura de SP_SELECTDEVICE_PARAMS corresponde a una solicitud de instalación de DIF_SELECTDEVICE .

Sintaxis

typedef struct _SP_SELECTDEVICE_PARAMS_A {
  SP_CLASSINSTALL_HEADER ClassInstallHeader;
  CHAR                   Title[MAX_TITLE_LEN];
  CHAR                   Instructions[MAX_INSTRUCTION_LEN];
  CHAR                   ListLabel[MAX_LABEL_LEN];
  CHAR                   SubTitle[MAX_SUBTITLE_LEN];
  BYTE                   Reserved[2];
} SP_SELECTDEVICE_PARAMS_A, *PSP_SELECTDEVICE_PARAMS_A;

Miembros

ClassInstallHeader

Encabezado de solicitud de instalación que contiene el tamaño del encabezado y el código DIF para la solicitud. Consulte SP_CLASSINSTALL_HEADER.

Title[MAX_TITLE_LEN]

Búfer que contiene un título de ventana proporcionado por el instalador para las ventanas de selección de controladores. Windows usa este título para el título de la ventana para los cuadros de diálogo Seleccionar dispositivo.

Instructions[MAX_INSTRUCTION_LEN]

Búfer que contiene instrucciones select-device proporcionadas por el instalador.

ListLabel[MAX_LABEL_LEN]

Búfer que contiene una etiqueta proporcionada por el instalador para la lista de controladores desde los que el usuario puede seleccionar.

SubTitle[MAX_SUBTITLE_LEN]

Búfer que contiene un subtítulo proporcionado por el instalador que se usa en los asistentes para seleccionar dispositivos. Esta cadena no se usa en los cuadros de diálogo de selección.

Reserved[2]

Reservado. Solo para uso interno.

Comentarios

Si un instalador establece los campos de esta estructura que se van a usar durante la selección del controlador, el instalador también debe establecer la marca de DI_USECI_SELECTSTRINGS en el SP_DEVINSTALL_PARAMS.

En la captura de pantalla siguiente se muestra un cuadro de diálogo Seleccionar dispositivo de ejemplo e identifica las cadenas que puede proporcionar un instalador.

Captura de pantalla del cuadro de diálogo Seleccionar un controlador de dispositivo

Nota

El encabezado setupapi.h define SP_SELECTDEVICE_PARAMS como un 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 Valor
Header setupapi.h (incluya Setupapi.h)

Consulte también

DIF_SELECTDEVICE

SP_CLASSINSTALL_HEADER

SetupDiCallClassInstaller

SetupDiSelectDevice