WdfDeviceRetrieveDeviceDirectoryString 函数 (wdfdevice.h)

  • 项目

[仅适用于 UMDF]

WdfDeviceRetrieveDeviceDirectoryString 提供磁盘上某个位置的路径，该路径可用于在重启后保存信息。

语法

NTSTATUS WdfDeviceRetrieveDeviceDirectoryString(
  [_In_] WDFDEVICE Device,
  [_In_] WDFSTRING String
);

参数

[_In_] Device

框架设备对象的句柄。

[_In_] String

框架字符串对象的句柄。 成功返回时，框架会将目录路径分配给字符串对象。

返回值

此函数返回 NTSTATUS。 如果操作成功，WdfDeviceRetrieveDeviceDirectoryString 将返回STATUS_SUCCESS。

注解

仅限 UMDF。 KMDF 驱动程序应使用 IoGetDeviceDirectory。

要求

要求 值
最低 UMDF 版本 2.25
标头 wdfdevice.h
IRQL PASSIVE_LEVEL

另请参阅

有关字符串对象的信息，请参阅 使用字符串对象。