EVT_WDF_DEVICE_FILE_CREATE função de retorno de chamada (wdfdevice.h)
[Aplica-se a KMDF e UMDF]
A função de retorno de chamada EvtDeviceFileCreate de um driver manipula operações que devem ser executadas quando um aplicativo solicita acesso a um dispositivo.
Sintaxe
EVT_WDF_DEVICE_FILE_CREATE EvtWdfDeviceFileCreate;
void EvtWdfDeviceFileCreate(
[in] WDFDEVICE Device,
[in] WDFREQUEST Request,
[in] WDFFILEOBJECT FileObject
)
{...}
Parâmetros
[in] Device
Um identificador para um objeto de dispositivo de estrutura.
[in] Request
Um identificador para um objeto de solicitação de estrutura que representa uma solicitação de criação de arquivo.
[in] FileObject
Um identificador para um objeto de arquivo de estrutura que descreve um arquivo que está sendo aberto para a solicitação especificada. Esse parâmetro será NULL se o driver tiver especificado WdfFileObjectNotRequired para o FileObjectClass membro da estrutura WDF_FILEOBJECT_CONFIG.
Valor de retorno
Nenhum
Observações
A estrutura chama a função de retorno de chamada EvtDeviceFileCreate de um driver quando um aplicativo de usuário ou outro driver abre o dispositivo para executar uma operação de E/S, como ler ou gravar um arquivo.
O driver pode passar o identificador solicitação de para WdfRequestGetParameters para recuperar parâmetros associados à solicitação de criação de arquivo. Os parâmetros são armazenados no membro Parameters.Create da estrutura WDF_REQUEST_PARAMETERS.
Essa função de retorno de chamada é chamada de forma síncrona, no contexto do thread que abre o dispositivo.
Para registrar uma função de retorno de chamada EvtDeviceFileCreate, o driver deve chamar o método WdfDeviceInitSetFileObjectConfig.
O driver deve concluir a solicitação ou enviá-la com WDF_REQUEST_SEND_OPTION_SEND_AND_FORGET.
Como alternativa, o driver pode receber solicitações de criação em uma fila. Para obter mais informações, consulte WdfDeviceConfigureRequestDispatching.
Para obter mais informações sobre objetos de arquivo de estrutura e a função de retorno de chamada EvtDeviceFileCreate, consulte de Objetos de Arquivo da Estrutura.
Requisitos
| Requisito | Valor |
|---|---|
| da Plataforma de Destino | Universal |
| versão mínima do KMDF | 1.0 |
| versão mínima do UMDF | 2.0 |
| cabeçalho | wdfdevice.h (inclua Wdf.h) |
| IRQL | PASSIVE_LEVEL |