Função WdfIoTargetGetDevice (wdfiotarget.h)

  • Artigo

[Aplica-se a KMDF e UMDF]

O método WdfIoTargetGetDevice retorna um identificador para o objeto de dispositivo de estrutura que é o pai do destino de E/S local ou remoto especificado.

Sintaxe

WDFDEVICE WdfIoTargetGetDevice(
  [in] WDFIOTARGET IoTarget
);

Parâmetros

[in] IoTarget

Um identificador para um objeto de destino de E/S. Esse identificador é obtido de WdfDeviceGetIoTarget, WdfIoTargetCreate ou de um método que um destino de E/S especializado fornece (como WdfUsbTargetDeviceGetIoTarget).

Retornar valor

WdfIoTargetGetDevice retorna um identificador para um objeto de dispositivo de estrutura.

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

Comentários

Para obter mais informações sobre WdfIoTargetGetDevice, consulte Obtendo informações sobre um destino de E/S geral.

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

Exemplos

O exemplo de código a seguir mostra como uma função de retorno de chamada EvtIoTargetQueryRemove pode chamar WdfIoTargetGetDevice.

NTSTATUS
MyEvtIoTargetQueryRemove(
    WDFIOTARGET IoTarget
)
{
WDFDEVICE device;
...
device = WdfIoTargetGetDevice(IoTarget);
...
}

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 wdfiotarget.h (inclua Wdf.h)
Biblioteca Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL <=DISPATCH_LEVEL
Regras de conformidade da DDI DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Confira também

WdfDeviceGetIoTarget

WdfIoTargetCreate

WdfUsbTargetDeviceGetIoTarget