estrutura SP_DEVICE_INTERFACE_DATA (setupapi.h)

Artigo
03/01/2024

Uma estrutura SP_DEVICE_INTERFACE_DATA define uma interface do dispositivo em um conjunto de informações do dispositivo.

Sintaxe

typedef struct _SP_DEVICE_INTERFACE_DATA {
  DWORD     cbSize;
  GUID      InterfaceClassGuid;
  DWORD     Flags;
  ULONG_PTR Reserved;
} SP_DEVICE_INTERFACE_DATA, *PSP_DEVICE_INTERFACE_DATA;

Membros

cbSize

O tamanho, em bytes, da estrutura SP_DEVICE_INTERFACE_DATA. Para obter mais informações, consulte a seção Comentários.

InterfaceClassGuid

O GUID da classe à qual a interface do dispositivo pertence.

Flags

Pode ser um ou mais dos seguintes:

SPINT_ACTIVE

A interface está ativa (habilitada).

SPINT_DEFAULT

A interface é a interface padrão para a classe de dispositivo.

SPINT_REMOVED

A interface é removida.

Reserved

Reservado. Não use.

Comentários

Uma função SetupAPI que usa uma instância da estrutura SP_DEVICE_INTERFACE_DATA como um parâmetro verifica se o membro cbSize da estrutura fornecida é igual ao tamanho, em bytes, da estrutura. Se o membro cbSize não estiver definido corretamente, a função falhará e definirá um código de erro de ERROR_INVALID_USER_BUFFER.