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

[Aviso: UMDF 2 é a versão mais recente do UMDF e substitui o UMDF 1. Todos os novos drivers UMDF devem ser gravados usando UMDF 2. Nenhum recurso novo 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 aoda UMDF .]

O método AutoForwardCreateCleanupClose controles de método 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 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.

Valor de retorno

Nenhum

Observações

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 função:

• Se o driver for um driver de filtro, o esquema de encaminhamento padrão será encaminhar as notificações de forma síncrona 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 encaminha 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 encaminha 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 encaminha 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 Balance of Create and Close Notifications to a Driver.

Requisitos

Requisito	Valor
fim do suporte	Indisponível no UMDF 2.0 e posterior.
da Plataforma de Destino	Área de trabalho
versão mínima do UMDF	1.5
cabeçalho	wudfddi.h (inclua Wudfddi.h)
de DLL	WUDFx.dll

Consulte também

IFileCallbackCleanup::OnCleanupFile

IFileCallbackClose::OnCloseFile

IQueueCallbackCreate::OnCreateFile

IWDFDeviceInitialize