通过

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 枚举