estructura de SP_DRVINSTALL_PARAMS (setupapi.h)

Una estructura de SP_DRVINSTALL_PARAMS contiene parámetros de instalación de controladores asociados a un elemento de información de controlador determinado.

Sintaxis

typedef struct _SP_DRVINSTALL_PARAMS {
  DWORD     cbSize;
  DWORD     Rank;
  DWORD     Flags;
  DWORD_PTR PrivateData;
  DWORD     Reserved;
} SP_DRVINSTALL_PARAMS, *PSP_DRVINSTALL_PARAMS;

Miembros

cbSize

Tamaño, en bytes, de la estructura SP_DRVINSTALL_PARAMS.

Rank

Coincidencia de rango de este controlador. Oscila entre 0 y n, donde 0 es el más compatible.

Flags

Marca que controla las funciones que funcionan en este controlador. Puede ser una combinación de lo siguiente:

DNF_ALWAYSEXCLUDEFROMLIST (Windows Vista y versiones posteriores de Windows)

Si se establece, esta marca impide que se enumere el nodo del controlador , independientemente del cliente que realice la enumeración.

DNF_AUTHENTICODE_SIGNED (Windows Server 2003 y versiones posteriores de Windows)

El archivo INF de este controlador está firmado por una firma Authenticode. Esta marca es de solo lectura para instaladores.

Para obtener más información, consulte Uso de SetupAPI para comprobar las firmas authenticode del controlador.

DNF_BAD_DRIVER

No use este controlador. Los instaladores pueden leer y escribir esta marca.

Si se establece esta marca, SetupDiSelectBestCompatDrv y SetupDiSelectDevice omiten este controlador.

Un instalador de clase o coinsertor puede establecer esta marca para impedir que Windows muestre el controlador en el cuadro de diálogo Seleccionar controlador. Un instalador puede establecer esta marca cuando controla una solicitud de DIF_SELECTDEVICE o DIF_SELECTBESTCOMPATDRV , por ejemplo.

DNF_BASIC_DRIVER (Windows XP y versiones posteriores de Windows)

Este controlador es un controlador básico. Esta marca es de solo lectura para instaladores.

DNF_CLASS_DRIVER

Este controlador es un controlador de clase. Esta marca es de solo lectura para instaladores.

DNF_COMPATIBLE_DRIVER

Este controlador es un controlador compatible. Esta marca es de solo lectura para instaladores.

DNF_DUPDESC

Hay otros proveedores que suministran controladores que tienen la misma descripción que este controlador. Esta marca es de solo lectura para instaladores.

DNF_DUPDRIVERVER (Windows XP y versiones posteriores de Windows)

Hay otros proveedores que proporcionan controladores que tienen la misma versión que este controlador. Esta marca es de solo lectura para instaladores.

DNF_DUPPROVIDER

Hay otros proveedores que suministran controladores que tienen la misma descripción que este controlador. La única diferencia entre este controlador y su coincidencia es la fecha del controlador. Esta marca es de solo lectura para instaladores.

Si se establece esta marca, Windows muestra la fecha del controlador y la versión del controlador junto al controlador para que el usuario pueda distinguirla de su coincidencia.

DNF_EXCLUDEFROMLIST

No muestre este controlador en ningún cuadro de diálogo de selección de controladores.

DNF_INBOX_DRIVER (Windows Vista y versiones posteriores de Windows)

Este nodo de controlador se deriva de un archivo INF que se incluyó con esta versión de Windows.

DNF_INET_DRIVER

Este controlador proviene de Internet o de Windows Update. Esta marca es de solo lectura para instaladores.

Si llama a SetupCopyOEMInf , debe especificar la marca SPOST_URL para que cuando Windows copie este INF en el directorio %SystemRoot%\inf , Windows lo marcará como un INF de Internet. Si omite este paso, Windows intentará usar este dispositivo para instalar otros dispositivos. El problema resultante es que Windows ya no tiene los archivos de origen y terminará preguntando al usuario por una ruta de acceso no válida.

DNF_INF_IS_SIGNED (Windows XP y versiones posteriores de Windows)

Esta marca es de solo lectura para los instaladores y se establece si se cumple alguna de las condiciones siguientes:

• El controlador tiene una firma de versión WHQL.
• El controlador es un controlador de bandeja de entrada.
• El controlador tiene una firma Authenticode.

DNF_INSTALLEDDRIVER (Windows Vista y versiones posteriores de Windows)

Este nodo de controlador está instalado actualmente para el dispositivo. Esta marca es de solo lectura para instaladores.

DNF_LEGACYINF

Este controlador procede de un archivo INF heredado. Esta marca solo es válida para el sistema operativo basado en NT. Esta marca es de solo lectura para instaladores.

DNF_NODRIVER

Establezca si no hay ningún controlador físico que se instale para este controlador lógico.

DNF_OEM_F6_INF (Windows XP y versiones posteriores de Windows)

Reservado.

DNF_OLD_INET_DRIVER

Este controlador procede de Internet, pero Windows no tiene acceso actualmente a sus archivos de origen. Esta marca es de solo lectura para instaladores.

El sistema no instalará un controlador marcado con esta marca porque Windows no tiene los archivos de origen y acabaría preguntando al usuario por una ruta de acceso no válida. El INF de este tipo de controlador se puede usar para todo excepto para instalar dispositivos.

DNF_OLDDRIVER

Este controlador controla actualmente o previamente el dispositivo asociado. Esta marca es de solo lectura para instaladores.

DNF_REQUESTADDITIONALSOFTWARE (Windows 7 y versiones posteriores de Windows)

Establezca esta marca si el paquete de controladores solo forma parte de la solución de software necesaria para operar el dispositivo. En este caso, el paquete de controladores requiere la instalación de software adicional.

Para obtener más información, vea la sección Comentarios que se muestra más adelante.

PrivateData

Un campo que un instalador de clase puede usar para almacenar datos privados. Los coins installers no deben usar este campo.

Reserved

Reservado. Solo para uso interno.

Comentarios

A partir de Windows 7, un instalador o coinstalador puede establecer la marca de DNF_REQUESTADDITIONALSOFTWARE para indicar que el paquete de controladores requiere software adicional que puede o no estar instalado en el equipo.

Una vez instalado el paquete de controladores para el dispositivo, el administrador de Plug and Play (PnP) realiza los pasos siguientes si el instalador establece la marca DNF_REQUESTADDITIONALSOFTWARE:

1. El administrador de PnP genera un informe de errores de informe de problemas y solución (PRS) con el tipo de RequestAddtionalSoftware. Este informe contiene información sobre el identificador de hardware específico del dispositivo y la arquitectura del sistema del equipo.
2. Si hay una solución proporcionada por el proveedor de hardware independiente (IHV) para el software específico del dispositivo, la solución se descarga en el equipo.
   Nota La descarga de la solución no instala el propio software.
    
3. Si el software específico del dispositivo no está instalado en el equipo, el administrador de PnP presenta la solución al usuario y proporciona un vínculo para descargar el software. A continuación, el usuario puede descargar e instalar este software siguiendo las instrucciones que se presentan en la solución.

Requisitos

Consulte también

SetupDiGetDriverInstallParams

SetupDiSetDriverInstallParams