Função GetDeviceDriverFileNameA (psapi.h)

Artigo
11/20/2024

Recupera o caminho disponível para o driver de dispositivo especificado.

Sintaxe

DWORD GetDeviceDriverFileNameA(
  [in]  LPVOID ImageBase,
  [out] LPSTR  lpFilename,
  [in]  DWORD  nSize
);

Parâmetros

[in] ImageBase

O endereço de carga do driver do dispositivo.

[out] lpFilename

Um ponteiro para o buffer que recebe o caminho para o driver do dispositivo.

[in] nSize

O tamanho do buffer lpFilename, em caracteres. Se o buffer não for grande o suficiente para armazenar o caminho mais o caractere nulo de encerramento, a cadeia de caracteres será truncada.

Valor de retorno

Se a função for bem-sucedida, o valor retornado especifica o comprimento da cadeia de caracteres copiada para o buffer, sem incluir nenhum caractere nulo de encerramento.

Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.

Observações

Começando com o Windows 7 e o Windows Server 2008 R2, o Psapi.h estabelece números de versão para as funções PSAPI. O número de versão do PSAPI afeta o nome usado para chamar a função e a biblioteca que um programa deve carregar.

Se PSAPI_VERSION for 2 ou maior, essa função será definida como K32GetDeviceDriverFileName no Psapi.h e exportada em Kernel32.lib e Kernel32.dll. Se PSAPI_VERSION for 1, essa função será definida como GetDeviceDriverFileName no Psapi.h e exportada em Psapi.lib e Psapi.dll como um wrapper que chama K32GetDeviceDriverFileName .

Os programas que devem ser executados em versões anteriores do Windows, bem como no Windows 7 e versões posteriores, sempre devem chamar essa função como GetDeviceDriverFileName. Para garantir a resolução correta de símbolos, adicione Psapi.lib à macro TARGETLIBS e compile o programa com –DPSAPI_VERSION=1. Para usar a vinculação dinâmica em tempo de execução, carregue Psapi.dll.

Nota

O cabeçalho psapi.h define GetDeviceDriverFileName como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows XP [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows Server 2003 [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	psapi.h
biblioteca	Kernel32.lib no Windows 7 e Windows Server 2008 R2; Psapi.lib (se PSAPI_VERSION=1) no Windows 7 e Windows Server 2008 R2; Psapi.lib no Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP
de DLL	Kernel32.dll no Windows 7 e no Windows Server 2008 R2; Psapi.dll (se PSAPI_VERSION=1) no Windows 7 e no Windows Server 2008 R2; Psapi.dll no Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP

Consulte também

de informações do driver de dispositivo

EnumDeviceDrivers

Funções PSAPI

Compartilhar via