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 membro FileObjectClass da estrutura WDF_FILEOBJECT_CONFIG .

Retornar valor

Nenhum

Comentários

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 de solicitação 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 Objetos de arquivo de estrutura.

Requisitos

Confira também

WDF_FILEOBJECT_CONFIG