Функция WdfDriverGetRegistryPath (wdfdriver.h)

  • Статья

[Относится к KMDF и UMDF]

Метод WdfDriverGetRegistryPath извлекает путь к разделу реестра драйвера в дереве служб реестра.

Синтаксис

PWSTR WdfDriverGetRegistryPath(
  [in] WDFDRIVER Driver
);

Параметры

[in] Driver

Дескриптор объекта драйвера платформы драйвера, полученный при предыдущем вызове WdfDriverCreate или WdfGetDriver.

Возвращаемое значение

WdfDriverGetRegistryPath возвращает указатель на строку Юникода, завершающуюся null, которая представляет путь к реестру драйвера. Системная ошибка проверка возникает, если дескриптор драйвера недопустим.

Комментарии

Строка пути к реестру, возвращаемая WdfDriverGetRegistryPath , получается из структуры UNICODE_STRING , которую драйвер получил в качестве входных данных в свою подпрограмму DriverEntry .

Дополнительные сведения о реестре см. в разделе Использование реестра в Framework-Based Drivers.

Примеры

В следующем примере кода получается путь к разделу реестра драйвера в дереве служб реестра.

PWSTR  registryPath;

registryPath = WdfDriverGetRegistryPath(driver);

Требования

Требование Значение
Целевая платформа Универсальное
Минимальная версия KMDF 1,0
Минимальная версия UMDF 2,0
Верхняя часть wdfdriver.h (включая Wdf.h)
Библиотека Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL PASSIVE_LEVEL
Правила соответствия DDI DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

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

UNICODE_STRING

WdfDriverCreate

WdfDriverOpenParametersRegistryKey

WdfGetDriver