Função SetupDiGetDriverInfoDetailW (setupapi.h)
A função SetupDiGetDriverInfoDetail recupera detalhes de informações do driver para um conjunto de informações do dispositivo ou um elemento de informações de dispositivo específico no conjunto de informações do dispositivo.
Sintaxe
WINSETUPAPI BOOL SetupDiGetDriverInfoDetailW(
[in] HDEVINFO DeviceInfoSet,
[in, optional] PSP_DEVINFO_DATA DeviceInfoData,
[in] PSP_DRVINFO_DATA_W DriverInfoData,
[in, out] PSP_DRVINFO_DETAIL_DATA_W DriverInfoDetailData,
[in] DWORD DriverInfoDetailDataSize,
[out, optional] PDWORD RequiredSize
);
Parâmetros
[in] DeviceInfoSet
Um identificador para um conjunto de informações do dispositivo que contém um elemento de informações do driver para o qual recuperar informações do driver.
[in, optional] DeviceInfoData
Um ponteiro para uma estrutura SP_DEVINFO_DATA que especifica um elemento de informações do dispositivo que representa o dispositivo para o qual recuperar informações do driver. Esse parâmetro é opcional e pode ser NULL. Se esse parâmetro for especificado, SetupDiGetDriverInfoDetail recuperará informações sobre um driver em uma lista de driver para o dispositivo especificado. Se esse parâmetro for NULL, SetupDiGetDriverInfoDetail recuperará informações sobre um driver que é membro da lista de drivers de classe global para DeviceInfoSet.
[in] DriverInfoData
Um ponteiro para uma estrutura SP_DRVINFO_DATA que especifica o elemento de informações do driver que representa o driver para o qual recuperar detalhes. Se DeviceInfoData for especificado, o driver deverá ser um membro da lista de driver para o dispositivo especificado por DeviceInfoData. Caso contrário, o driver deve ser um membro da lista de drivers de classe global para DeviceInfoSet.
[in, out] DriverInfoDetailData
Um ponteiro para uma estrutura SP_DRVINFO_DETAIL_DATA que recebe informações detalhadas sobre o driver especificado. Se esse parâmetro não for especificado, DriverInfoDetailDataSize deverá ser zero. Se esse parâmetro for especificado, DriverInfoDetailData.cbSize deve ser definido como o valor de sizeof(SP_DRVINFO_DETAIL_DATA) antes de chamar SetupDiGetDriverInfoDetail.
[in] DriverInfoDetailDataSize
O tamanho, em bytes, do buffer DriverInfoDetailData .
[out, optional] RequiredSize
Um ponteiro para uma variável que recebe o número de bytes necessários para armazenar as informações detalhadas do driver. Esse valor inclui o tamanho da estrutura e os bytes adicionais necessários para o buffer de caracteres de comprimento variável no final que contém a lista de IDs de hardware e a lista de IDs compatíveis. As listas estão no formato REG_MULTI_SZ. Para obter informações sobre hardware e IDs compatíveis, consulte Cadeias de caracteres de identificação do dispositivo.
Retornar valor
A função retornará TRUE se for bem-sucedida. Caso contrário, ele retornará FALSE e o erro registrado poderá ser recuperado fazendo uma chamada para GetLastError.
Comentários
Se o membro de informações do driver especificado e o buffer fornecido pelo chamador forem válidos, essa função deverá preencher todos os campos estáticos na estrutura SP_DRVINFO_DETAIL_DATA e o máximo possível de IDs no buffer de comprimento variável no final, mantendo REG_MULTI_SZ formato. Nesse caso, a função retorna FALSE e uma chamada para GetLastError retorna ERROR_INSUFFICIENT_BUFFER. Se especificado, RequiredSize contém o número total de bytes necessários para a estrutura com todas as IDs.
Observação
O cabeçalho setupapi.h define SetupDiGetDriverInfoDetail 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 |
---|---|
Cliente mínimo com suporte | Disponível no Microsoft Windows 2000 e versões posteriores do Windows. |
Plataforma de Destino | Área de Trabalho |
Cabeçalho | setupapi.h (inclua Setupapi.h) |
Biblioteca | Setupapi.lib |
Confira também
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de