共用方式為

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，則會停用支援特殊文件類型。

返回值

沒有

備註

如果驅動程式提供無效的物件句柄，就會發生錯誤檢查。

函式驅動程式通常會從 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