Função SetupDiSetDeviceInterfaceDefault (setupapi.h)

A função SetupDiSetDeviceInterfaceDefault define uma interface do dispositivo como a interface padrão para uma classe de interface do dispositivo.

Sintaxe

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

Parâmetros

[in] DeviceInfoSet

Um identificador para o conjunto de informações do dispositivo que contém a interface do dispositivo a ser definida como o padrão para uma classe de interface do dispositivo.

[in, out] DeviceInterfaceData

Um ponteiro para uma estrutura SP_DEVICE_INTERFACE_DATA que especifica a interface do dispositivo em DeviceInfoSet.

[in] Flags

Não usado, deve ser zero.

Reserved

Reservado para uso futuro, deve ser NULL.

Retornar valor

A função retornará TRUE se for bem-sucedida. Caso contrário, ele retornará FALSE e o erro registrado poderá ser recuperado com uma chamada para GetLastError.

Comentários

Um chamador deve ter privilégios de Administrador para definir a interface padrão para uma classe de interface do dispositivo. No entanto, se a interface padrão solicitada for a mesma que a interface padrão definida no momento, a função retornará TRUE , independentemente de o chamador ter privilégios de Administrador.

Se a função definir com êxito a interface do dispositivo especificada como o padrão para a classe de dispositivo, ela atualizará o membro Flags da estrutura de SP_DEVICE_INTERFACE_DATA fornecida.

Chame SetupDiGetClassDevs para obter um identificador DevInfoSet para um conjunto de informações do dispositivo que contém a interface do dispositivo a ser definida como o padrão para uma classe de interface do dispositivo. Para obter o ponteiro DeviceInterfaceData para o elemento de interface do dispositivo, chame SetupDiEnumDeviceInterfaces para enumerar as interfaces no conjunto de informações do dispositivo. Para recuperar informações sobre uma interface enumerada, chame SetupDiGetDeviceInterfaceDetail.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Disponível no Windows XP e versões posteriores do Windows.
Plataforma de Destino	Área de Trabalho
Cabeçalho	setupapi.h (inclua Setupapi.h)
Biblioteca	Setupapi.lib
DLL	Setupapi.dll

Confira também

SetupDiEnumDeviceInterfaces

SetupDiGetClassDevs

SetupDiGetDeviceInterfaceDetail