Функция 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 |