Función WdfDeviceSetSpecialFileSupport (wdfdevice.h)
[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) |