Função WdfIoTargetGetDevice (wdfiotarget.h)
[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) |