Función SetupDiSetDeviceInterfaceDefault (setupapi.h)

La función SetupDiSetDeviceInterfaceDefault establece una interfaz de dispositivo como interfaz predeterminada para una clase de interfaz de dispositivo.

Sintaxis

WINSETUPAPI BOOL SetupDiSetDeviceInterfaceDefault(
  [in]      HDEVINFO                  DeviceInfoSet,
  [in, out] PSP_DEVICE_INTERFACE_DATA DeviceInterfaceData,
  [in]      DWORD                     Flags,
            PVOID                     Reserved
);

Parámetros

[in] DeviceInfoSet

Identificador del conjunto de información del dispositivo que contiene la interfaz de dispositivo que se va a establecer como valor predeterminado para una clase de interfaz de dispositivo.

[in, out] DeviceInterfaceData

Puntero a una estructura de SP_DEVICE_INTERFACE_DATA que especifica la interfaz del dispositivo en DeviceInfoSet.

[in] Flags

No se usa, debe ser cero.

Reserved

Reservado para uso futuro, debe ser NULL.

Valor devuelto

La función devuelve TRUE si se realiza correctamente. De lo contrario, devuelve FALSE y el error registrado se puede recuperar con una llamada a GetLastError.

Comentarios

Un llamador debe tener privilegios de administrador para establecer la interfaz predeterminada para una clase de interfaz de dispositivo. Sin embargo, si la interfaz predeterminada solicitada es la misma que la interfaz predeterminada establecida actualmente, la función devuelve TRUE independientemente de si el autor de la llamada tiene privilegios de administrador.

Si la función establece correctamente la interfaz de dispositivo especificada como predeterminada para la clase de dispositivo, actualiza el miembro Flags de la estructura de SP_DEVICE_INTERFACE_DATA proporcionada.

Llame a SetupDiGetClassDevs para obtener un identificador DevInfoSet a un conjunto de información del dispositivo que contiene la interfaz de dispositivo que se va a establecer como valor predeterminado para una clase de interfaz de dispositivo. Para obtener el puntero DeviceInterfaceData al elemento de interfaz del dispositivo, llame a SetupDiEnumDeviceInterfaces para enumerar las interfaces del conjunto de información del dispositivo. Para recuperar información sobre una interfaz enumerada, llame a SetupDiGetDeviceInterfaceDetail.

Requisitos

Requisito	Value
Cliente mínimo compatible	Disponible en Windows XP y versiones posteriores de Windows.
Plataforma de destino	Escritorio
Encabezado	setupapi.h (incluya Setupapi.h)
Library	Setupapi.lib
Archivo DLL	Setupapi.dll

Consulte también

SetupDiEnumDeviceInterfaces

SetupDiGetClassDevs

SetupDiGetDeviceInterfaceDetail