estrutura SP_DEVICE_INTERFACE_DETAIL_DATA_A (setupapi.h)

Uma estrutura SP_DEVICE_INTERFACE_DETAIL_DATA contém o caminho de uma interface do dispositivo.

Sintaxe

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;

Membros

cbSize

O tamanho, em bytes, da estrutura SP_DEVICE_INTERFACE_DETAIL_DATA. Para obter mais informações, consulte a seção Comentários a seguir.

DevicePath[ANYSIZE_ARRAY]

Uma cadeia de caracteres terminada em NULL que contém o caminho da interface do dispositivo. Esse caminho pode ser passado para funções Win32, como CreateFile.

Comentários

Uma estrutura SP_DEVICE_INTERFACE_DETAIL_DATA identifica o caminho de uma interface do dispositivo em um conjunto de informações do dispositivo.

As funções SetupDiXxx que tomam uma estrutura SP_DEVICE_INTERFACE_DETAIL_DATA como parâmetro verificam se o membro cbSize da estrutura fornecida é igual ao tamanho, em bytes, da estrutura. Se o membro cbSize não estiver definido corretamente para um parâmetro de entrada, a função falhará e definirá um código de erro de ERROR_INVALID_PARAMETER. Se o membro cbSize não estiver definido corretamente para um parâmetro de saída, a função falhará e definirá um código de erro de ERROR_INVALID_USER_BUFFER.

Observação

O cabeçalho setupapi.h define SP_DEVICE_INTERFACE_DETAIL_DATA como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

Requisito Valor
Cabeçalho setupapi.h (inclua Setupapi.h)

Confira também

SetupDiGetDeviceInterfaceDetail