EVT_WDF_DEVICE_FILE_CREATE funzione di callback (wdfdevice.h)
[Si applica a KMDF e UMDF]
Il driver EvtDeviceFileCreate funzione di callback 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 per 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 il EvtDeviceFileCreate funzione di callback 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 di 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 un EvtDeviceFileCreate funzione di callback, 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 del framework e sulla EvtDeviceFileCreate funzione di callback, vedere Framework File Objects.
Fabbisogno
| Requisito | Valore |
|---|---|
| piattaforma di destinazione | Universale |
| versione minima di KMDF | 1.0 |
| versione minima di UMDF | 2.0 |
| intestazione | wdfdevice.h (include Wdf.h) |
| IRQL | PASSIVE_LEVEL |