Declarações de função KMDF do verificador de driver estático

Para habilitar o SDV para verificar seu driver KMDF, você deve declarar cada função de retorno de chamada, usando um tipo de função de retorno de chamada. Os tipos de função de retorno de chamada são definidos nos vários arquivos de cabeçalho WDF e são incluídos quando você cria seu driver com o arquivo de cabeçalho Wdf.h. A tabela a seguir mostra os tipos de papel de função e as funções de retorno de chamada de evento com as quais estão associados.

Você deve declarar as funções de retorno de chamada do driver antes das definições da função de retorno de chamada. O exemplo a seguir mostra a declaração do tipo de função para a função de retorno de chamada EvtDriverDeviceAdd. Neste exemplo, a função de retorno de chamada é chamada EvtDriverDeviceAdd.

#include <NTDDK.h>  
#include <wdf.h>
EVT_WDF_DRIVER_DEVICE_ADD EvtDriverDeviceAdd

Se uma função de retorno de chamada tiver uma declaração de protótipo de função, deve substituir o protótipo de função pela declaração de tipo de função. Para obter mais informações sobre as declarações de tipo de função, consulte Usando Declarações de Tipo de Função.

A tabela a seguir mostra os tipos de funções de retorno de chamada e as funções de retorno de chamada de evento às quais estão associadas.

Tipo de função	Função de callback de evento
EVT_WDF_CHILD_LIST_ADDRESS_DESCRIPTION_CLEANUP	EvtChildListAddressDescriptionCleanup
EVT_WDF_CHILD_LIST_ADDRESS_DESCRIPTION_COPY	EvtChildListAddressDescriptionCopy
EVT_WDF_CHILD_LIST_ADDRESS_DESCRIPTION_DUPLICATE	EvtChildListIdentificationDescriptionDuplicate
EVT_WDF_CHILD_LIST_CREATE_DEVICE	EvtChildListCreateDevice
EVT_WDF_CHILD_LIST_DEVICE_REENUMERATED	EvtChildListDeviceReenumerated
EVT_WDF_CHILD_LIST_IDENTIFICATION_DESCRIPTION_CLEANUP	EvtChildListIdentificationDescriptionCleanup
EVT_WDF_CHILD_LIST_IDENTIFICATION_DESCRIPTION_COMPARE	EvtChildListIdentificationDescriptionCompare
EVT_WDF_CHILD_LIST_IDENTIFICATION_DESCRIPTION_COPY	EvtChildListIdentificationDescriptionCopy
EVT_WDF_CHILD_LIST_IDENTIFICATION_DESCRIPTION_DUPLICATE	EvtChildListIdentificationDescriptionDuplicate
EVT_WDF_CHILD_LIST_SCAN_FOR_CHILDREN	EvtChildListScanForChildren
EVT_WDF_DEVICE_ARM_WAKE_FROM_S0	EvtDeviceArmWakeFromS0
EVT_WDF_DEVICE_ARM_WAKE_FROM_SX	EvtDeviceArmWakeFromSx
EVT_WDF_DEVICE_CONTEXT_CLEANUP	EvtCleanupCallback
EVT_WDF_DEVICE_CONTEXT_DESTROY	EvtDestroyCallback
EVT_WDF_DEVICE_D0_ENTRY	EvtDeviceD0Entry
EVT_WDF_DEVICE_D0_ENTRY_POST_INTERRUPTS_ENABLED (Entrada D0 de dispositivo WDF pós-habilitação de interrupções)	EvtDeviceD0EntryPostInterruptsEnabled
EVT_WDF_DEVICE_D0_EXIT	EvtDeviceD0Exit
EVT_WDF_DEVICE_D0_EXIT_PRE_INTERRUPTS_DISABLED	EvtDeviceD0ExitPreInterruptsDisabled
EVT_WDF_DEVICE_DISABLE_WAKE_AT_BUS	EvtDeviceDisableWakeAtBus
EVT_WDF_DEVICE_DISARM_WAKE_FROM_S0	EvtDeviceDisarmWakeFromS0
EVT_WDF_DEVICE_DISARM_WAKE_FROM_SX	EvtDeviceDisarmWakeFromSx
EVT_WDF_DEVICE_EJECT	EvtDeviceEject
EVT_WDF_DEVICE_ENABLE_WAKE_AT_BUS	EvtDeviceEnableWakeAtBus
EVT_WDF_DEVICE_FILE_CREATE	EvtDeviceFileCreate
EVT_WDF_DEVICE_FILTER_RESOURCE_REQUIREMENTS	EvtDeviceFilterAddResourceRequirements
EVT_WDF_DEVICE_PNP_STATE_CHANGE_NOTIFICATION	EvtDevicePnpStateChange
EVT_WDF_DEVICE_POWER_POLICY_STATE_CHANGE_NOTIFICATION (notificação de mudança de estado de política de energia do dispositivo)	EvtDevicePnpStateChange
EVT_WDF_DEVICE_POWER_STATE_CHANGE_NOTIFICATION	EvtDevicePowerStateChange
EVT_WDF_DEVICE_PREPARE_HARDWARE	EvtDevicePrepareHardware
EVT_WDF_DEVICE_PROCESS_QUERY_INTERFACE_REQUEST	EvtDeviceProcessQueryInterfaceRequest
EVT_WDF_DEVICE_QUERY_REMOVE	EvtDeviceQueryRemove
EVT_WDF_DEVICE_QUERY_STOP	EvtDeviceQueryStop
EVT_WDF_DEVICE_RELATIONS_QUERY	EvtDeviceRelationsQuery
EVT_WDF_DEVICE_RELEASE_HARDWARE	EvtDeviceReleaseHardware
EVT_WDF_DEVICE_REMOVE_ADDED_RESOURCES	EvtDeviceRemoveAddedResources
EVT_WDF_QUERY_REQUISITOS_RECURSOS_DISPOSITIVO	EvtDeviceResourceRequirementsQuery
EVT_WDF_DEVICE_RESOURCES_QUERY	EvtDeviceResourcesQuery
EVT_WDF_DEVICE_SELF_MANAGED_IO_CLEANUP	EvtDeviceSelfManagedIoCleanup
EVT_WDF_DEVICE_SELF_MANAGED_IO_FLUSH	EvtDeviceSelfManagedIoFlush
EVT_WDF_DEVICE_SELF_MANAGED_IO_INIT	EvtDeviceSelfManagedIoInit
EVT_WDF_DEVICE_SELF_MANAGED_IO_RESTART	EvtDeviceSelfManagedIoRestart
EVT_WDF_DEVICE_SELF_MANAGED_IO_SUSPEND	EvtDeviceSelfManagedIoSuspend
EVT_WDF_DEVICE_SET_LOCK	EvtDeviceSetLock
EVT_WDF_DEVICE_SHUTDOWN_NOTIFICATION	EvtDeviceShutdownNotification
EVT_WDF_DEVICE_SURPRISE_REMOVAL	EvtDeviceSurpriseRemoval
EVT_WDF_DEVICE_USAGE_NOTIFICATION	EvtDeviceUsageNotification
EVT_WDF_DEVICE_WAKE_FROM_S0_TRIGGERED	EvtDeviceWakeFromS0Triggered
EVT_WDF_DEVICE_WAKE_FROM_SX_TRIGGERED	** EvtDeviceWakeFromSxTriggered
EVT_WDF_DMA_ENABLER_DISABLE	EvtDmaEnablerDisable
EVT_WDF_DMA_ENABLER_ENABLE	EvtDmaEnablerEnable
EVT_WDF_DMA_ENABLER_FILL	EvtDmaEnablerFill
EVT_WDF_DMA_ENABLER_FLUSH	EvtDmaEnablerFlush
EVT_WDF_DMA_ENABLER_SELFMANAGED_IO_START	EvtDmaEnablerSelfManagedIoStart
EVT_WDF_DMA_ENABLER_SELFMANAGED_IO_STOP	EvtDmaEnablerSelfManagedIoStop
EVT_WDF_DPC	EvtDpcFunc
EVT_WDF_DRIVER_DEVICE_ADD	EvtDriverDeviceAdicionar
EVT_WDF_DRIVER_UNLOAD	EvtDriverUnload
EVT_WDF_FILE_CLEANUP	EvtFileCleanup
EVT_WDF_FILE_CLOSE	EvtFileClose
EVT_WDF_FILE_CONTEXT_CLEANUP_CALLBACK	EvtCleanupCallback
EVT_WDF_FILE_CONTEXT_DESTROY_CALLBACK	EvtDestroyCallback
EVT_WDF_INTERRUPT_DISABLE	EvtInterruptDisable
EVT_WDF_INTERRUPT_DPC	EvtInterruptDpc
EVT_WDF_INTERRUPT_ENABLE	EvtInterruptEnable
EVT_WDF_INTERRUPT_ISR	EvtInterruptIsr
EVT_WDF_INTERRUPT_SYNCHRONIZE	EvtInterruptSynchronize
EVT_WDF_IO_IN_CALLER_CONTEXT	#B0 #A1 EvtIoInCallerContext #A2 #C3
EVT_WDF_IO_QUEUE_CONTEXT_CLEANUP_CALLBACK	EvtCleanupCallback
EVT_WDF_IO_QUEUE_CONTEXT_DESTROY_CALLBACK	EvtDestroyCallback
EVT_WDF_IO_QUEUE_IO_CANCELED_ON_QUEUE	EvtIoCanceledOnQueue
EVT_WDF_IO_QUEUE_IO_DEFAULT	EvtIoDefault
EVT_WDF_IO_QUEUE_IO_DEVICE_CONTROL	EvtIoDeviceControl
EVT_WDF_IO_QUEUE_IO_INTERNAL_DEVICE_CONTROL	EvtIoInternalDeviceControl
EVT_WDF_IO_QUEUE_IO_READ	EvtIoRead
EVT_WDF_IO_QUEUE_IO_RESUME	EvtIoResume
EVT_WDF_IO_QUEUE_IO_STOP	EvtIoStop
EVT_WDF_IO_QUEUE_IO_WRITE	EvtIoWrite
EVT_WDF_IO_QUEUE_STATE	EvtIoQueueState
EVT_WDF_IO_TARGET_QUERY_REMOVE	EvtIoTargetQueryRemove
EVT_WDF_IO_DESTINO_REMOVER_CANCELADO	EvtIoTargetRemoveCanceled
EVT_WDF_IO_TARGET_REMOVE_COMPLETE	EvtIoTargetRemoveComplete
EVT_WDF_OBJECT_CONTEXT_CLEANUP	EvtCleanupCallback
EVT_WDF_OBJECT_CONTEXT_DESTROY
EVT_WDF_PROGRAM_DMA	EvtProgramDma
EVT_WDF_REQUEST_CANCEL	EvtPedidoCancelar
EVT_WDF_REQUEST_COMPLETION_ROUTINE	CompletionRoutine
EVT_WDF_TIMER	EvtTimerFunc
EVT_WDF_TRACE_CALLBACK
EVT_WDF_WMI_INSTANCE_EXECUTE_METHOD	EvtWmiInstanceExecuteMethod
EVT_WDF_WMI_INSTANCE_QUERY_INSTANCE	EvtWmiInstanceQueryInstance
EVT_WDF_WMI_INSTANCE_SET_INSTANCE	EvtWmiInstanceSetInstance
EVT_WDF_WMI_INSTANCE_SET_ITEM	EvtWmiInstanceSetItem
EVT_WDF_WMI_PROVIDER_FUNCTION_CONTROL	EvtWmiProviderFunctionControl
EVT_WDF_WORKITEM	EvtWorkItem
EVT_WDFDEVICE_WDM_IRP_PREPROCESS	EvtDeviceWdmIrpPreprocess

Tipos de função que permitem múltiplos retornos de chamada

Existem alguns tipos de papéis de função que podem ter várias funções de callback de eventos associadas a eles. Por exemplo, um driver pode ter várias funções de retorno de chamada EvtTimerFunc ou EvtDpcFunc. A tabela a seguir mostra o número máximo de retornos de chamada que o SDV suporta para cada tipo de função. Embora não seja incorreto para um driver ter um número de funções de retorno de chamada superior ao máximo listado na tabela, isso acaba por complicar o processo de verificação ao usar SDV. Para obter informações sobre alterações que talvez seja necessário fazer no arquivo Sdv-map.h para acomodar as funções de retorno de chamada adicionais, consulte Pontos de entrada duplicados para um tipo de papel de função.

Tipo de função	Número máximo de funções de retorno de chamada
EVT_WDF_DPC	7
EVT_WDF_INTERRUPT_SYNCHRONIZE	11
EVT_WDF_TIMER	6
EVT_WDF_WMI_INSTANCE_EXECUTE_METHOD	5
EVT_WDF_WMI_INSTANCE_QUERY_INSTANCE	5
EVT_WDF_WMI_INSTANCE_SET_INSTANCE	5
EVT_WDF_WMI_INSTANCE_SET_ITEM	5

Tipos de função e filas de E/S

Use os seguintes tipos de função ao declarar os manipuladores de solicitação e as funções de retorno de chamada que dependem da estrutura KMDF para entregar as solicitações de E/S ao driver (para despacho sequencial ou paralelo). Não use esses tipos de função para as funções que encaminham manualmente solicitações da fila padrão para outras filas (despacho manual). O SDV não suporta um modelo de memória que lhe permita controlar pedidos de uma fila para outra.

Para obter mais informações sobre filas de E/S, consulte Criação de filas de E/S.

Tipos de função usados para fila de E/S configurada para despacho manual
EVT_WDF_IO_QUEUE_CONTEXT_CLEANUP_CALLBACK
EVT_WDF_IO_QUEUE_CONTEXT_DESTROY_CALLBACK
EVT_WDF_IO_QUEUE_IO_CANCELED_ON_QUEUE
EVT_WDF_IO_QUEUE_IO_DEFAULT
EVT_WDF_IO_QUEUE_IO_DEVICE_CONTROL
EVT_WDF_IO_QUEUE_IO_INTERNAL_DEVICE_CONTROL
EVT_WDF_IO_QUEUE_IO_READ
EVT_WDF_IO_QUEUE_IO_RESUME
EVT_WDF_IO_QUEUE_IO_STOP
EVT_WDF_IO_QUEUE_IO_WRITE
EVT_WDF_IO_QUEUE_STATE

Tipos de função para as funções EvtCleanupCallback e EvtDestroyCallback

Você deve declarar a função EvtCleanupCallback e EvtDestroyCallback com tipos de função específicos do objeto. O SDV requer estes tipos de papéis específicos para objeto para determinar se o driver está usando corretamente a função de retorno de chamada. Use as tabelas a seguir para determinar qual tipo de função usar.

Tipo de objeto	Tipo de função para EvtCleanupCallback
Objeto do dispositivo	EVT_WDF_DEVICE_CONTEXT_CLEANUP
Objeto de fila de E/S	EVT_WDF_IO_QUEUE_CONTEXT_CLEANUP_CALLBACK
Objeto de arquivo	EVT_WDF_FILE_CONTEXT_CLEANUP_CALLBACK
Todos os outros objetos	EVT_WDF_OBJECT_CONTEXT_CLEANUP

Tipo de objeto	Tipo de função para EvDestroyCallback
Objeto do dispositivo	EVT_WDF_DEVICE_CONTEXT_DESTROY
Objeto de fila de E/S	EVT_WDF_IO_QUEUE_CONTEXT_DESTROY_CALLBACK
Objeto de arquivo	EVT_WDF_FILE_CONTEXT_DESTROY_CALLBACK
Todos os outros objetos	EVT_WDF_OBJECT_CONTEXT_DESTROY