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

  • Artículo

[Advertencia: UMDF 2 es la versión más reciente de UMDF y sustituye a UMDF 1. Todos los controladores UMDF nuevos deben escribirse con UMDF 2. No se agregan nuevas características a UMDF 1 y hay compatibilidad limitada con UMDF 1 en versiones más recientes de Windows 10. Los controladores universales de Windows deben usar UMDF 2. Para obtener más información, consulta Introducción con UMDF.

El método AutoForwardCreateCleanupClose controla al crear, limpiar y cerrar las notificaciones se reenvía al siguiente controlador inferior de la pila de dispositivos.

Sintaxis

void AutoForwardCreateCleanupClose(
  [in] WDF_TRI_STATE State
);

Parámetros

[in] State

Valor de tipo WDF_TRI_STATE que identifica el estado del reenvío automático. En la siguiente tabla se muestran los valores posibles.

Valor Significado
WdfUseDefault (0) El marco usa el esquema de reenvío predeterminado. Para obtener más información, vea la sección Comentarios que se muestra más adelante.
WdfFalse (1) El marco no reenvía las notificaciones de creación, limpieza y cierre al siguiente controlador inferior.
WdfTrue (2) El marco reenvía de forma sincrónica las notificaciones de creación, limpieza y cierre al siguiente controlador inferior.

Valor devuelto

None

Observaciones

Si el controlador UMDF pasa WdfUseDefault para el parámetro State en una llamada a AutoForwardCreateCleanupClose, el marco usa un esquema de reenvío predeterminado para crear, limpiar y cerrar notificaciones que dependen de si el controlador es un controlador de filtro o función:

  • Si el controlador es un controlador de filtro, el esquema de reenvío predeterminado es reenviar notificaciones sincrónicas al siguiente controlador inferior.
  • Si el controlador es un controlador de función, el esquema de reenvío predeterminado no es reenviar las notificaciones al siguiente controlador inferior.
Si el marco está configurado para el reenvío, reenvía las notificaciones de limpieza y cierre, independientemente de si el controlador admite los métodos de interfaz IFileCallbackCleanup::OnCleanupFile e IFileCallbackClose::OnCloseFile . Sin embargo, el marco reenvía automáticamente solicitudes de creación solo si el controlador no admite el método IQueueCallbackCreate::OnCreateFile . Si el controlador admite IQueueCallbackCreate::OnCreateFile, el marco reenvía las solicitudes de creación solo si el controlador configura explícitamente el reenvío (WdfTrue) al siguiente controlador inferior.

Para obtener más información sobre cómo un controlador UMDF usa AutoForwardCreateCleanupClose, vea Evitar un desequilibrio de las notificaciones de creación y cierre en un controlador.

Requisitos

Requisito Value
Finalización del soporte técnico No disponible en UMDF 2.0 y versiones posteriores.
Plataforma de destino Escritorio
Versión mínima de UMDF 1.5
Encabezado wudfddi.h (incluya Wudfddi.h)
Archivo DLL WUDFx.dll

Consulte también

IFileCallbackCleanup::OnCleanupFile

IFileCallbackClose::OnCloseFile

IQueueCallbackCreate::OnCreateFile

IWDFDeviceInitialize