Objeto de arquivo do Framework

A interface IWDFFile expõe o objeto de arquivo de estrutura aos drivers. É a representação da estrutura do dispositivo aberto. Quando um aplicativo abre o dispositivo por meio da função Microsoft Win32 CreateFile, a estrutura cria um objeto de arquivo para representar a instância do dispositivo aberto. Portanto, o objeto de ficheiro do framework é conceitualmente equivalente ao identificador Win32 que é retornado pela chamada do aplicativo para CreateFile. A estrutura pode criar vários objetos de arquivo associados a um único dispositivo. Cada objeto de arquivo é criado para cada chamada bem-sucedida para CreateFile. Todas as operações de E/S, como leituras e gravações, são direcionadas a uma instância específica de objeto de arquivo.

Observação Todas as solicitações passadas para drivers UMDF estão associadas a objetos de arquivo. No entanto, as solicitações que são passadas para os drivers WDM e KMDF às vezes não são associadas a objetos de arquivo.

Um driver UMDF pode chamar o método IWDFIoRequest::GetFileObject para obter o objeto de arquivo associado a uma solicitação.

Quando o driver chama GetFileObject, a estrutura incrementa a contagem de referência na interface. O controlador é responsável por liberar a referência ao concluir com o ponteiro da interface. Para fazer isso, use um ponteiro inteligente que diminua automaticamente a contagem de referência quando o objeto sair do contexto ou chame Release na interface quando terminar de usá-lo. Para obter um exemplo de código que mostra como usar um ponteiro inteligente, consulte GetFileObject.