struttura SP_DEVINFO_DATA (setupapi.h)
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) |