структура SP_DEVICE_INTERFACE_DETAIL_DATA_A (setupapi.h)

  • Статья

Структура SP_DEVICE_INTERFACE_DETAIL_DATA содержит путь к интерфейсу устройства.

Синтаксис

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;

Члены

cbSize

Размер структуры SP_DEVICE_INTERFACE_DETAIL_DATA в байтах. Дополнительные сведения см. в разделе "Примечания".

DevicePath[ANYSIZE_ARRAY]

Строка с завершением NULL, содержащая путь к интерфейсу устройства. Этот путь можно передать функциям Win32, таким как CreateFile.

Комментарии

Структура SP_DEVICE_INTERFACE_DETAIL_DATA определяет путь к интерфейсу устройства в наборе сведений об устройстве.

Функции SetupDiXxx, которые принимают SP_DEVICE_INTERFACE_DETAIL_DATA структуру в качестве параметра, проверяют, что член cbSize предоставленной структуры равен размеру структуры в байтах. Если член cbSize неправильно задан для входного параметра, функция завершится ошибкой и задаст код ошибки ERROR_INVALID_PARAMETER. Если член cbSize неправильно задан для выходного параметра, функция завершится ошибкой и задаст код ошибки ERROR_INVALID_USER_BUFFER.

Примечание

Заголовок setupapi.h определяет SP_DEVICE_INTERFACE_DETAIL_DATA в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора UNICODE. Сочетание использования псевдонима, не зависящий от кодировки, с кодом, не зависящим от кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования

Требование Значение
Заголовок setupapi.h (включая Setupapi.h)

См. также раздел

SetupDiGetDeviceInterfaceDetail