EVT_WDF_DEVICE_FILE_CREATE función de devolución de llamada (wdfdevice.h)
[Se aplica a KMDF y UMDF]
La EvtDeviceFileCreate función de devolución de llamada controla las operaciones que deben realizarse 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
Ninguno
Observaciones
El marco llama a la función de devolución de llamada EvtDeviceFileCreate 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 de 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 de WDF_REQUEST_PARAMETERS.
Esta función de devolución de llamada se denomina sincrónicamente, en el contexto del subproceso que abre el dispositivo.
Para registrar un EvtDeviceFileCreate función de devolución de llamada, 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 Framework File Objects.
Requisitos
| Requisito | Valor |
|---|---|
| de la plataforma de destino de | Universal |
| versión mínima de KMDF | 1.0 |
| versión mínima de UMDF | 2.0 |
| encabezado de | wdfdevice.h (incluya Wdf.h) |
| irQL | PASSIVE_LEVEL |