EVT_WDF_DEVICE_FILE_CREATE función de devolución de llamada (wdfdevice.h)
[Se aplica a KMDF y UMDF]
La función evtDeviceFileCreate de devolución de llamada de un controlador controla las operaciones que se deben realizar cuando una aplicación solicita acceso a un dispositivo.
Sintaxis
EVT_WDF_DEVICE_FILE_CREATE EvtWdfDeviceFileCreate;
void EvtWdfDeviceFileCreate(
[in] WDFDEVICE Device,
[in] WDFREQUEST Request,
[in] WDFFILEOBJECT FileObject
)
{...}
Parámetros
[in] Device
Identificador de un objeto de dispositivo de marco.
[in] Request
Identificador de un objeto de solicitud de marco que representa una solicitud de creación de archivos.
[in] FileObject
Identificador de un objeto de archivo de marco que describe un archivo que se abre para la solicitud especificada. Este parámetro es NULL si el controlador ha especificado WdfFileObjectNotRequired para el miembro FileObjectClass de la estructura WDF_FILEOBJECT_CONFIG .
Valor devuelto
None
Observaciones
El marco llama a la función de devolución de llamada EvtDeviceFileCreate de un controlador cuando una aplicación de usuario u otro controlador abre el dispositivo para realizar una operación de E/S, como leer o escribir un archivo.
El controlador puede pasar el identificador de solicitud a WdfRequestGetParameters para recuperar parámetros asociados a la solicitud de creación de archivos. Los parámetros se almacenan en el miembro Parameters.Create de la estructura WDF_REQUEST_PARAMETERS .
Esta función de devolución de llamada se denomina de forma sincrónica, en el contexto del subproceso que abre el dispositivo.
Para registrar una función de devolución de llamada EvtDeviceFileCreate , el controlador debe llamar al método WdfDeviceInitSetFileObjectConfig .
El controlador debe completar la solicitud o enviarlo con WDF_REQUEST_SEND_OPTION_SEND_AND_FORGET.
Como alternativa, el controlador puede recibir solicitudes de creación en una cola. Para obtener más información, consulta WdfDeviceConfigureRequestDispatching.
Para obtener más información sobre los objetos de archivo de marco y la función de devolución de llamada EvtDeviceFileCreate , vea Objetos de archivo de marco.
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Universal |
| Versión mínima de KMDF | 1.0 |
| Versión mínima de UMDF | 2.0 |
| Encabezado | wdfdevice.h (incluya Wdf.h) |
| IRQL | PASSIVE_LEVEL |