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

Статья
02/27/2024

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

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

None

Remarks

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

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

Поддержка каждого драйвера для специальных файлов изначально отключается, пока драйвер не вызовет 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