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) |