通过

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