Función WdfDeviceSetSpecialFileSupport (wdfdevice.h)
[Solo se aplica a KMDF]
El método WdfDeviceSetSpecialFileSupport habilita o deshabilita la compatibilidad de un 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_TYPEque identifica el tipo de archivo especial que admite el controlador.
[in] FileTypeIsSupported
Proporciona un valor booleano que, si TRUE, habilita la compatibilidad con el tipo de archivo especial y, si FALSE, deshabilita la compatibilidad con el tipo de archivo especial.
Valor devuelto
Ninguno
Observaciones
Se produce una comprobación de errores si el controlador proporciona un identificador de objeto no válido.
Normalmente, un controlador de funciones 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 | Valor |
|---|---|
| de la plataforma de destino de | Universal |
| versión mínima de KMDF | 1.0 |
| encabezado | wdfdevice.h (incluya Wdf.h) |
| Biblioteca | 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) |