struttura SP_DEVINFO_DATA (setupapi.h)

  • Articolo

Una struttura SP_DEVINFO_DATA definisce un'istanza del dispositivo membro di un set di informazioni sul dispositivo.

Sintassi

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

Members

cbSize

Dimensione, in byte, della struttura SP_DEVINFO_DATA. Per ulteriori informazioni, vedere la sezione Osservazioni successiva.

ClassGuid

GUID della classe di installazione del dispositivo.

DevInst

Handle opaco per l'istanza del dispositivo (noto anche come handle per devnode).

Alcune funzioni, ad esempio Le funzioni SetupDiXxx , accettano l'intera struttura SP_DEVINFO_DATA come input per identificare un dispositivo in un set di informazioni sul dispositivo. Altre funzioni, ad esempio CM_Xxx , come CM_Get_DevNode_Status, accettano questo handle DevInst come input.

Reserved

Riservato. Solo per uso interno.

Commenti

Una struttura SP_DEVINFO_DATA identifica un dispositivo in un set di informazioni sul dispositivo. Ad esempio, quando Windows invia una richiesta di DIF_INSTALLDEVICE a un programma di installazione di classe e ai co-programmi di installazione, include un handle per un set di informazioni sul dispositivo e un puntatore a un SP_DEVINFO_DATA che specifica il dispositivo specifico. Oltre alle richieste DIF, questa struttura viene usata anche in alcune funzioni SetupDiXxx .

Le funzioni SetupDiXxx che accettano una struttura SP_DEVINFO_DATA come parametro verificano che il membro cbSize della struttura fornita sia uguale alle dimensioni, in byte, della struttura. Se il membro cbSize non è impostato correttamente per un parametro di input, la funzione avrà esito negativo e imposterà un codice di errore di ERROR_INVALID_PARAMETER. Se il membro cbSize non è impostato correttamente per un parametro di output, la funzione avrà esito negativo e imposterà un codice di errore di ERROR_INVALID_USER_BUFFER.

Requisiti

   
Intestazione setupapi.h (include Setupapi.h)

Vedi anche

SP_DEVINFO_LIST_DETAIL_DATA