WDF_IO_TARGET_OPEN_TYPE enumeração (wdfiotarget.h)

Artigo
02/29/2024

[Aplica-se a KMDF e UMDF]

A enumeração WDF_IO_TARGET_OPEN_TYPE especifica como um driver identifica um destino de E/S remoto quando o driver chama WdfIoTargetOpen.

Syntax

typedef enum _WDF_IO_TARGET_OPEN_TYPE {
  WdfIoTargetOpenUndefined = 0,
  WdfIoTargetOpenUseExistingDevice = 1,
  WdfIoTargetOpenByName = 2,
  WdfIoTargetOpenReopen = 3,
  WdfIoTargetOpenLocalTargetByFile = 4
} WDF_IO_TARGET_OPEN_TYPE;

Constantes


`WdfIoTargetOpenUndefined` Valor: 0 Reservado para uso do sistema.
`WdfIoTargetOpenUseExistingDevice` Valor: 1 Esse valor é compatível apenas com KMDF. O driver está identificando um destino de E/S remoto fornecendo um ponteiro para uma estrutura de DEVICE_OBJECT do Modelo de Driver do Windows (WDM).
`WdfIoTargetOpenByName` Valor: 2 O driver está abrindo um destino de E/S remoto fornecendo uma cadeia de caracteres de nome Unicode que representa um nome de objeto. Esse nome pode identificar um dispositivo, arquivo ou interface do dispositivo.
`WdfIoTargetOpenReopen` Valor: 3 O driver está reabrindo um destino de E/S remoto depois de chamar anteriormente WdfIoTargetCloseForQueryRemove. Para obter mais informações, consulte a seção Comentários a seguir.
`WdfIoTargetOpenLocalTargetByFile` Valor: 4 Esse valor é compatível apenas com UMDF. UMDF O driver está abrindo um identificador de arquivo que representa a pilha inferior (assim como um destino local), para que ele possa enviar uma solicitação criada pelo driver para a pilha inferior. Um driver UMDF especifica esse valor quando chama WDF_IO_TARGET_OPEN_PARAMS_INIT_OPEN_BY_FILE.

Comentários

A enumeração WDF_IO_TARGET_OPEN_TYPE é usada no membro Type da estrutura WDF_IO_TARGET_OPEN_PARAMS .

O driver pode especificar WdfIoTargetOpenReopen somente se ele especificou WdfIoTargetOpenByName quando abriu originalmente o destino de E/S remoto.

Se WdfIoTargetOpenReopen estiver definido, a estrutura ignorará todos os outros membros da estrutura WDF_IO_TARGET_OPEN_PARAMS e usará os valores especificados pelo driver quando ele originalmente chamou WdfIoTargetOpen para abrir um destino de E/S remoto.

Por padrão (a menos que o driver especifique UmdfFileObjectPolicy=AllowNullAndUnknownFileObjects em seu arquivo INF), o UMDF não permite o processamento de solicitações de E/S que não estão associadas a um objeto de arquivo. Além disso, algumas pilhas de driver, como PDOs da coleção enumerada HIDclass, falham em solicitações que não têm nenhum objeto de arquivo associado.

Ao contrário das solicitações criadas pelo aplicativo, as solicitações criadas pelo driver enviadas a um destino de E/S local não têm nenhum objeto de arquivo associado. Como resultado, a estrutura ou o driver inferior podem falhar nessas solicitações.

Nessa situação, você pode usar WdfIoTargetOpenLocalTargetByFile para fazer com que as solicitações criadas pelo driver enviadas a um destino local sejam associadas ao objeto de arquivo correspondente a esse destino.