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

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

  • Статья

[Относится только к 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