estrutura SP_DEVINFO_DATA (setupapi.h)

Uma estrutura SP_DEVINFO_DATA define uma instância de dispositivo que é membro de um conjunto de informações do dispositivo.

Sintaxe

typedef struct _SP_DEVINFO_DATA {
  DWORD     cbSize;
  GUID      ClassGuid;
  DWORD     DevInst;
  ULONG_PTR Reserved;
} SP_DEVINFO_DATA, *PSP_DEVINFO_DATA;

Membros

cbSize

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

ClassGuid

O GUID da classe de configuração do dispositivo.

DevInst

Um identificador opaco para a instância do dispositivo (também conhecido como identificador para o devnode).

Algumas funções, como as funções SetupDiXxx , assumem toda a estrutura SP_DEVINFO_DATA como entrada para identificar um dispositivo em um conjunto de informações do dispositivo. Outras funções, como funções CM_Xxx como CM_Get_DevNode_Status, assumem esse identificador DevInst como entrada.

Reserved

Reservado. Apenas para uso interno.

Comentários

Uma estrutura SP_DEVINFO_DATA identifica um dispositivo em um conjunto de informações do dispositivo. Por exemplo, quando o Windows envia uma solicitação DIF_INSTALLDEVICE para um instalador de classe e co-instaladores, ele inclui um identificador para um conjunto de informações do dispositivo e um ponteiro para um SP_DEVINFO_DATA que especifica o dispositivo específico. Além das solicitações DIF, essa estrutura também é usada em algumas funções SetupDiXxx .

As funções SetupDiXxx que tomam uma estrutura SP_DEVINFO_DATA como parâmetro verificam se o membro cbSize da estrutura fornecida é igual ao tamanho, em bytes, da estrutura. Se o membro cbSize não estiver definido corretamente para um parâmetro de entrada, a função falhará e definirá um código de erro de ERROR_INVALID_PARAMETER. Se o membro cbSize não estiver definido corretamente para um parâmetro de saída, a função falhará e definirá um código de erro de ERROR_INVALID_USER_BUFFER.

Requisitos

Cabeçalho	setupapi.h (inclua Setupapi.h)

Confira também

SP_DEVINFO_LIST_DETAIL_DATA