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

Consulte también

WDF_FILEOBJECT_CONFIG