Функция WdfDeviceSetSpecialFileSupport (wdfdevice.h)

Статья
03/22/2025

[Применимо только к 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, отключает поддержку специального типа файла.

Возвращаемое значение

Нет

Замечания

Ошибка возникает, если драйвер предоставляет недопустимый дескриптор объекта.

Драйвер функции обычно вызывает WdfDeviceSetSpecialFileSupport из функции обратного вызова EvtDriverDeviceAdd.

Поддержка каждого драйвера для специальных файлов изначально отключена, пока драйвер не вызывает WdfDeviceSetSpecialFileSupport.

Дополнительные сведения см. в поддержке специальных файлов.

Примеры

В следующем примере кода поддерживается поддержка разбиения по страницам, гибернации и дампа файлов на устройстве.

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

Требования

Требование	Ценность
целевая платформа	универсальный
минимальная версия KMDF	1.0
Заголовок	wdfdevice.h (include Wdf.h)
Библиотека	Wdf01000.sys (см. управление версиями библиотеки Платформы).)
IRQL	<=DISPATCH_LEVEL
правил соответствия DDI	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

См. также

EvtDriverDeviceAdd

WDF_SPECIAL_FILE_TYPE

Поделиться через