通过

WdfDeviceSetSpecialFileSupport 函数 （wdfdevice.h）

  • 项目

[仅适用于 KMDF]

WdfDeviceSetSpecialFileSupport 方法启用或禁用对指定设备的特殊文件的函数驱动程序支持。

语法

void WdfDeviceSetSpecialFileSupport(
  [in] WDFDEVICE             Device,
  [in] WDF_SPECIAL_FILE_TYPE FileType,
  [in] BOOLEAN               FileTypeIsSupported
);

参数

[in] Device

框架设备对象的句柄。

[in] FileType

一个 WDF_SPECIAL_FILE_TYPE类型化枚举器，用于标识驱动程序支持的特殊文件的类型。

[in] FileTypeIsSupported

提供一个布尔值，如果 TRUE，则启用对特殊文件类型的支持;如果 FALSE，则禁用支持特殊文件类型。

返回值

没有

注解

如果驱动程序提供无效的对象句柄，则会发生 bug 检查。

函数驱动程序通常从 EvtDriverDeviceAdd 回调函数内部调用 WdfDeviceSetSpecialFileSupport。

最初禁用每个驱动程序对特殊文件的支持，直到驱动程序调用 WdfDeviceSetSpecialFileSupport。

有关详细信息，请参阅 支持特殊文件。

例子

下面的代码示例支持设备上的分页、休眠和转储文件。

WdfDeviceSetSpecialFileSupport(
                               device,
                               WdfSpecialFilePaging,
                               TRUE
                               );
WdfDeviceSetSpecialFileSupport(
                               device,
                               WdfSpecialFileHibernation,
                               TRUE
                               );
WdfDeviceSetSpecialFileSupport(
                               device,
                               WdfSpecialFileDump,
                               TRUE
                               );

要求

要求 价值
目标平台 普遍
最低 KMDF 版本 1.0
标头 wdfdevice.h （包括 Wdf.h）
图书馆 Wdf01000.sys（请参阅框架库版本控制。
IRQL <=DISPATCH_LEVEL
DDI 符合性规则 DriverCreate（kmdf），KmdfIrql（kmdf），KmdfIrql2（kmdf），KmdfIrqlExplicit（kmdf）

另请参阅

EvtDriverDeviceAdd

WDF_SPECIAL_FILE_TYPE