Compartilhar via


Função WdfDriverGetRegistryPath (wdfdriver.h)

[Aplica-se a KMDF e UMDF]

O método WdfDriverGetRegistryPath recupera o caminho para a chave do registro do driver na árvore serviços do registro.

Sintaxe

PWSTR WdfDriverGetRegistryPath(
  [in] WDFDRIVER Driver
);

Parâmetros

[in] Driver

Um identificador para o objeto de driver da estrutura do driver, obtido por uma chamada anterior para WdfDriverCreate ou WdfGetDriver.

Valor de retorno

WdfDriverGetRegistryPath retorna um ponteiro para uma cadeia de caracteres Unicode terminada em NULL que representa o caminho do registro do driver. Uma verificação de bugs do sistema ocorre se o identificador de do Driver for inválido.

Observações

A cadeia de caracteres de caminho do Registro que WdfDriverGetRegistryPath retorna é obtida da estrutura de UNICODE_STRING que o driver recebeu como entrada para sua rotina de DriverEntry.

Para obter mais informações sobre o registro, consulte Usando o Registro nodrivers Framework-Based.

Exemplos

O exemplo de código a seguir obtém o caminho para a chave do Registro de um driver na árvore serviços de do registro.

PWSTR  registryPath;

registryPath = WdfDriverGetRegistryPath(driver);

Requisitos

Requisito Valor
da Plataforma de Destino Universal
versão mínima do KMDF 1.0
versão mínima do UMDF 2.0
cabeçalho wdfdriver.h (inclua Wdf.h)
Biblioteca Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL PASSIVE_LEVEL
regras de conformidade de DDI DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Consulte também

UNICODE_STRING

WdfDriverCreate

WdfDriverOpenParametersRegistryKey

do WdfGetDriver