estructura SP_SELECTDEVICE_PARAMS_W (setupapi.h)

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

Sintaxis

typedef struct _SP_SELECTDEVICE_PARAMS_W {
  SP_CLASSINSTALL_HEADER ClassInstallHeader;
  WCHAR                  Title[MAX_TITLE_LEN];
  WCHAR                  Instructions[MAX_INSTRUCTION_LEN];
  WCHAR                  ListLabel[MAX_LABEL_LEN];
  WCHAR                  SubTitle[MAX_SUBTITLE_LEN];
} SP_SELECTDEVICE_PARAMS_W, *PSP_SELECTDEVICE_PARAMS_W;

Miembros

ClassInstallHeader

Encabezado de solicitud de instalación que contiene el tamaño del encabezado y el código DIF de 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 de selección de dispositivo 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.

Comentarios

Si un instalador establece los campos de esta estructura que se usarán durante la selección del controlador, el instalador también debe establecer la marca 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.

Nota

El encabezado setupapi.h define SP_SELECTDEVICE_PARAMS 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 neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o 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