EVT_WDF_DEVICE_FILE_CREATE funzione di callback (wdfdevice.h)

[Si applica a KMDF e UMDF]

La funzione di callback EvtDeviceFileCreate di un driver gestisce le operazioni che devono essere eseguite quando un'applicazione richiede l'accesso a un dispositivo.

Sintassi

EVT_WDF_DEVICE_FILE_CREATE EvtWdfDeviceFileCreate;

void EvtWdfDeviceFileCreate(
  [in] WDFDEVICE Device,
  [in] WDFREQUEST Request,
  [in] WDFFILEOBJECT FileObject
)
{...}

Parametri

[in] Device

Handle per un oggetto dispositivo framework.

[in] Request

Handle per un oggetto richiesta framework che rappresenta una richiesta di creazione di file.

[in] FileObject

Handle a un oggetto file framework che descrive un file che viene aperto per la richiesta specificata. Questo parametro è NULL se il driver ha specificato WdfFileObjectNotRequired per il membro FileObjectClass della struttura WDF_FILEOBJECT_CONFIG .

Valore restituito

nessuno

Osservazioni

Il framework chiama la funzione di callback EvtDeviceFileCreate del driver quando un'applicazione utente o un altro driver apre il dispositivo per eseguire un'operazione di I/O, ad esempio la lettura o la scrittura di un file.

Il driver può passare l'handle richiesta a WdfRequestGetParameters per recuperare i parametri associati alla richiesta di creazione del file. I parametri vengono archiviati nel membro Parameters.Create della struttura WDF_REQUEST_PARAMETERS .

Questa funzione di callback viene chiamata in modo sincrono, nel contesto del thread che apre il dispositivo.

Per registrare una funzione di callback EvtDeviceFileCreate , il driver deve chiamare il metodo WdfDeviceInitSetFileObjectConfig .

Il driver deve completare la richiesta o inviarla con WDF_REQUEST_SEND_OPTION_SEND_AND_FORGET.

In alternativa, il driver può ricevere richieste di creazione in una coda. Per altre informazioni, vedere WdfDeviceConfigureRequestDispatching.

Per altre informazioni sugli oggetti file framework e sulla funzione di callback EvtDeviceFileCreate , vedere Oggetti file framework.

Requisiti

Vedi anche

WDF_FILEOBJECT_CONFIG