Compartilhar via


Regra UsbDeviceCreateTarget (kmdf)

A regra UsbDeviceCreateTarget especifica que vários objetos WDFUSBDEVICE não são criados enquanto objetos WDFUSBDEVICE que estão atualmente no contexto do dispositivo são vazados.

Por exemplo, a função de retorno de chamada de evento EvtDevicePrepareHardware pode ser chamada várias vezes quando o sistema está tentando gerenciar recursos e precisa alocar uma parte diferente da memória para o driver. Nessa situação, a função de retorno de chamada de evento EvtDeviceReleaseHardware é chamada para desmapear recursos de memória depois que a estrutura tiver chamado inicialmente EvtDevicePrepareHardware. O EvtDevicePrepareHardware é chamado novamente para mapear recursos para que o driver possa acessar a memória atribuída ao dispositivo. Essa regra verifica se o driver primeiro verifica se o WDFUSBDEVICE de destino é NULL e não simplesmente cria um novo dispositivo e substitui o identificador anterior.

Modelo de driver: KMDF

Como testar

Em tempo de compilação

Execute o Verificador de Driver Estático e especifique a regra UsbDeviceCreateTarget .

Use as seguintes etapas para executar uma análise do código:
  1. Prepare seu código (use declarações de tipo de função).
  2. Execute o Verificador de Driver Estático.
  3. Exiba e analise os resultados.

Para obter mais informações, consulte Usando o verificador de driver estático para localizar defeitos em drivers.

Aplica-se a

WdfUsbTargetDeviceCreateWdfUsbTargetDeviceCreateWithParameters