Função WdfDeviceGetIoTarget (wdfdevice.h)

  • Artigo

[Aplica-se a KMDF e UMDF]

O método WdfDeviceGetIoTarget retorna um identificador para um destino de E/S local do driver de função ou filtro, para um dispositivo especificado.

Sintaxe

WDFIOTARGET WdfDeviceGetIoTarget(
  [in] WDFDEVICE Device
);

Parâmetros

[in] Device

Um identificador para um objeto de dispositivo de estrutura.

Retornar valor

Se a operação for bem-sucedida, WdfDeviceGetIoTarget retornará um identificador para um objeto de destino de E/S da estrutura. Se o objeto de dispositivo de estrutura especificado representar um PDO, o método retornará NULL.

Um bug marcar ocorrerá se o driver fornecer um identificador de objeto inválido.

Comentários

Quando um driver UMDF envia uma solicitação criada pelo driver para um destino de E/S local, a solicitação não tem nenhum objeto de arquivo associado. Alguns destinos inferiores, como um PDO bruto enumerado hidclasse, falham nas solicitações que não têm nenhum objeto de arquivo associado. Nessa situação, um driver UMDF pode especificar WdfIoTargetOpenLocalTargetByFile para criar um destino de E/S que representa a pilha inferior (assim como um destino local) usando um identificador de arquivo. Como resultado, todas as solicitações criadas pelo driver enviadas para esse destino de E/S são associadas ao objeto de arquivo correspondente ao identificador aberto.

Para fazer isso, chame a função WDF_IO_TARGET_OPEN_PARAMS_INIT_OPEN_BY_FILE antes de chamar WdfIoTargetOpen.

Para obter mais informações sobre destinos de E/S, consulte Usando destinos de E/S.

Exemplos

O exemplo de código a seguir obtém um identificador para o destino de E/S local de um dispositivo especificado.

WDFIOTARGET  ioTargetHandle;

ioTargetHandle = WdfDeviceGetIoTarget(device);

Requisitos

Requisito Valor
Plataforma de Destino Universal
Versão mínima do KMDF 1.0
Versão mínima do UMDF 2,0
Cabeçalho wdfdevice.h (inclua Wdf.h)
Biblioteca Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL <= DISPATCH_LEVEL
Regras de conformidade de DDI DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)