Función WdfDeviceSetSpecialFileSupport (wdfdevice.h)

  • Artículo

[Solo se aplica a KMDF]

El método WdfDeviceSetSpecialFileSupport habilita o deshabilita la compatibilidad del controlador de función con archivos especiales para el dispositivo especificado.

Sintaxis

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

Parámetros

[in] Device

Identificador de un objeto de dispositivo de marco.

[in] FileType

Enumerador con tipo WDF_SPECIAL_FILE_TYPE que identifica el tipo de archivo especial que admite el controlador.

[in] FileTypeIsSupported

Proporciona un valor booleano que, si es TRUE, habilita la compatibilidad con el tipo de archivo especial y, si es FALSE, deshabilita el tipo de archivo especial.

Valor devuelto

None

Observaciones

Se produce una comprobación de errores si el controlador proporciona un identificador de objeto no válido.

Un controlador de función normalmente llama a WdfDeviceSetSpecialFileSupport desde su función de devolución de llamada EvtDriverDeviceAdd .

La compatibilidad de cada controlador con archivos especiales se deshabilita inicialmente hasta que el controlador llama a WdfDeviceSetSpecialFileSupport.

Para obtener más información, vea Compatibilidad con archivos especiales.

Ejemplos

En el ejemplo de código siguiente se habilita la compatibilidad con la paginación, hibernación y volcado de archivos en un dispositivo.

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

Requisitos

Requisito Value
Plataforma de destino Universal
Versión mínima de KMDF 1.0
Encabezado wdfdevice.h (incluir Wdf.h)
Library Wdf01000.sys (consulte Control de versiones de la biblioteca de marcos).
IRQL <=DISPATCH_LEVEL
Reglas de cumplimiento de DDI DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Consulte también

EvtDriverDeviceAdd

WDF_SPECIAL_FILE_TYPE