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

Статья
03/22/2025

[Применимо только к UMDF]

Метод WdfDriverRetrieveDriverDataDirectoryString возвращает путь к каталогу на диске, в котором драйвер может хранить сведения. Файлы в этом каталоге применяются к определенному объекту драйвера платформы.

Синтаксис

NTSTATUS WdfDriverRetrieveDriverDataDirectoryString(
  [_In_] WDFDRIVER Driver,
  [_In_] WDFSTRING String
);

Параметры

[_In_] Driver

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

[_In_] String

Дескриптор строки платформы, полученный драйвером из предыдущего вызова WdfStringCreate. Платформа назначает полный путь запрошенного каталога драйверов строковой объекту.

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

WdfDriverRetrieveDriverDataDirectoryString возвращает STATUS_SUCCESS, если операция выполнена успешно. В противном случае этот метод возвращает соответствующий код ошибки NTSTATUS. Дополнительные сведения см. в значения NTSTATUS.

Замечания

Чтобы добиться того же результата, драйвер KMDF должен вызывать IoGetDriverDirectory.

Дополнительные сведения о строковых объектах см. в разделе Использование строковых объектов.

Примеры

В следующем примере кода показано, как вызывать WdfDriverRetrieveDriverDataDirectoryString:

NTSTATUS status;
WDFSTRING string;

status = WdfStringCreate(
                         NULL,
                         WDF_NO_OBJECT_ATTRIBUTES,
                         &string
                         );
if (NT_SUCCESS(status)) {
    status = WdfDriverRetrieveDriverDataDirectoryString(
                         Driver,
                         string
                         );
    if (!NT_SUCCESS(status)) {
        return status;
    }
}

Требования

Требование	Ценность
минимальная версия UMDF	2.27
Заголовок	wdfdriver.h
IRQL	PASSIVE_LEVEL

См. также

IoGetDriverDirectory

перечисление _DRIVER_DIRECTORY_TYPE

Поделиться через