estructura de SP_DEVINFO_DATA (setupapi.h)
Una estructura de SP_DEVINFO_DATA define una instancia de dispositivo que es miembro de un conjunto de información de dispositivo.
Sintaxis
typedef struct _SP_DEVINFO_DATA {
DWORD cbSize;
GUID ClassGuid;
DWORD DevInst;
ULONG_PTR Reserved;
} SP_DEVINFO_DATA, *PSP_DEVINFO_DATA;
Miembros
cbSize
Tamaño, en bytes, de la estructura SP_DEVINFO_DATA. Para obtener más información, vea la sección Comentarios que se muestra más adelante.
ClassGuid
GUID de la clase de configuración del dispositivo.
DevInst
Un identificador opaco para la instancia del dispositivo (también conocido como identificador para el devnode).
Algunas funciones, como las funciones SetupDiXxx , toman toda la estructura de SP_DEVINFO_DATA como entrada para identificar un dispositivo en un conjunto de información del dispositivo. Otras funciones, como las funciones CM_Xxx , como CM_Get_DevNode_Status, toman este identificador de DevInst como entrada.
Reserved
Reservado. Solo para uso interno.
Comentarios
Una estructura de SP_DEVINFO_DATA identifica un dispositivo en un conjunto de información del dispositivo. Por ejemplo, cuando Windows envía una solicitud de DIF_INSTALLDEVICE a un instalador de clase y co-installers, incluye un identificador para un conjunto de información del dispositivo y un puntero a un SP_DEVINFO_DATA que especifica el dispositivo determinado. Además de las solicitudes DIF, esta estructura también se usa en algunas funciones SetupDiXxx .
Las funciones SetupDiXxx que toman una estructura de SP_DEVINFO_DATA como parámetro comprueban que el miembro cbSize de la estructura proporcionada sea igual al tamaño, en bytes, de la estructura. Si el miembro cbSize no está configurado correctamente para un parámetro de entrada, se producirá un error en la función y se establecerá un código de error de ERROR_INVALID_PARAMETER. Si el miembro cbSize no está configurado correctamente para un parámetro de salida, se producirá un error en la función y se establecerá un código de error de ERROR_INVALID_USER_BUFFER.
Requisitos
| Encabezado | setupapi.h (incluya Setupapi.h) |