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
                               );

規格需求

需求 值
目標平台 Universal
最小 KMDF 版本 1.0
標頭 wdfdevice.h (包含 Wdf.h)
程式庫 Wdf01000.sys (請參閱 Framework Library Versioning.)
IRQL <=DISPATCH_LEVEL
DDI 合規性規則 DriverCreate (kmdf) 、 KmdfIrql (kmdf) 、 KmdfIrql2 (kmdf) 、 KmdfIrqlExplicit (kmdf)

另請參閱

EvtDriverDeviceAdd

WDF_SPECIAL_FILE_TYPE