SP_DEVICE_INTERFACE_DETAIL_DATA_A estructura (setupapi.h)

Una estructura de SP_DEVICE_INTERFACE_DETAIL_DATA contiene la ruta de acceso de una interfaz de dispositivo.

Sintaxis

typedef struct _SP_DEVICE_INTERFACE_DETAIL_DATA_A {
  DWORD cbSize;
  CHAR  DevicePath[ANYSIZE_ARRAY];
} SP_DEVICE_INTERFACE_DETAIL_DATA_A, *PSP_DEVICE_INTERFACE_DETAIL_DATA_A;

Miembros

cbSize

Tamaño, en bytes, de la estructura SP_DEVICE_INTERFACE_DETAIL_DATA. Para obtener más información, vea la sección Comentarios que se muestra más adelante.

DevicePath[ANYSIZE_ARRAY]

Cadena terminada en NULL que contiene la ruta de acceso de la interfaz del dispositivo. Esta ruta de acceso se puede pasar a funciones win32 como CreateFile.

Comentarios

Una estructura de SP_DEVICE_INTERFACE_DETAIL_DATA identifica la ruta de acceso de una interfaz de dispositivo en un conjunto de información de dispositivo.

Las funciones SetupDiXxx que toman una estructura SP_DEVICE_INTERFACE_DETAIL_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.

Nota

El encabezado setupapi.h define SP_DEVICE_INTERFACE_DETAIL_DATA como un alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.

Requisitos

Requisito	Valor
Header	setupapi.h (incluya Setupapi.h)

Consulte también

SetupDiGetDeviceInterfaceDetail