Partilhar via

Método IWDFDeviceInitialize::AutoForwardCreateCleanupClose (wudfddi.h)

  • Artigo

[Aviso: UMDF 2 é a versão mais recente do UMDF e substitui UMDF 1. Todos os novos drivers UMDF devem ser gravados usando UMDF 2. Nenhum novo recurso está sendo adicionado ao UMDF 1 e há suporte limitado para UMDF 1 em versões mais recentes do Windows 10. Os drivers universais do Windows devem usar o UMDF 2. Para obter mais informações, consulte Introdução com UMDF.]

O método AutoForwardCreateCleanupClose controla quando as notificações de criação, limpeza e fechamento são encaminhadas para o próximo driver inferior na pilha do dispositivo.

Sintaxe

void AutoForwardCreateCleanupClose(
  [in] WDF_TRI_STATE State
);

Parâmetros

[in] State

Um valor do tipo WDF_TRI_STATE que identifica o estado do encaminhamento automático. A tabela a seguir mostra os valores possíveis.

Valor Significado
WdfUseDefault (0) A estrutura usa o esquema de encaminhamento padrão. Para obter mais informações, consulte a seção Comentários a seguir.
WdfFalse (1) A estrutura não encaminha notificações de criação, limpeza e fechamento para o próximo driver inferior.
WdfTrue (2) A estrutura encaminha de forma síncrona as notificações de criação, limpeza e fechamento para o próximo driver inferior.

Retornar valor

Nenhum

Comentários

Se o driver UMDF passar WdfUseDefault para o parâmetro State em uma chamada para AutoForwardCreateCleanupClose, a estrutura usará um esquema de encaminhamento padrão para criar, limpar e fechar notificações que dependem se o driver é um driver de filtro ou de função:

  • Se o driver for um driver de filtro, o esquema de encaminhamento padrão será encaminhar de forma síncrona as notificações para o próximo driver inferior.
  • Se o driver for um driver de função, o esquema de encaminhamento padrão não será encaminhar notificações para o próximo driver inferior.
Se a estrutura estiver configurada para encaminhamento, ela encaminhará notificações de limpeza e fechamento, independentemente de o driver dar suporte aos métodos de interface IFileCallbackCleanup::OnCleanupFile e IFileCallbackClose::OnCloseFile . No entanto, a estrutura encaminhará automaticamente solicitações de criação somente se o driver não der suporte ao método IQueueCallbackCreate::OnCreateFile . Se o driver der suporte a IQueueCallbackCreate::OnCreateFile, a estrutura encaminhará solicitações de criação somente se o driver configurar explicitamente o encaminhamento (WdfTrue) para o próximo driver inferior.

Para obter mais informações sobre como um driver UMDF usa AutoForwardCreateCleanupClose, consulte Preventing an Imbalance of Create and Close Notifications to a Driver.

Requisitos

Requisito Valor
Fim do suporte Indisponível no UMDF 2.0 e posterior.
Plataforma de Destino Área de Trabalho
Versão mínima do UMDF 1.5
Cabeçalho wudfddi.h (inclua Wudfddi.h)
DLL WUDFx.dll

Confira também

IFileCallbackCleanup::OnCleanupFile

IFileCallbackClose::OnCloseFile

IQueueCallbackCreate::OnCreateFile

IWDFDeviceInitialize