Функция WdfIoTargetGetDevice (wdfiotarget.h)
[Относится к KMDF и UMDF]
Метод WdfIoTargetGetDevice возвращает дескриптор объекту устройства платформы, который является родительским объектом указанного локального или удаленного целевого объекта ввода-вывода.
Синтаксис
WDFDEVICE WdfIoTargetGetDevice(
[in] WDFIOTARGET IoTarget
);
Параметры
[in] IoTarget
Дескриптор целевого объекта ввода-вывода. Этот дескриптор получается из WdfDeviceGetIoTarget, WdfIoTargetCreate или из метода, который предоставляет специализированный целевой объект ввода-вывода (например , WdfUsbTargetDeviceGetIoTarget).
Возвращаемое значение
WdfIoTargetGetDevice возвращает дескриптор объекту устройства платформы.
Ошибка проверка возникает, если драйвер предоставляет недопустимый дескриптор объекта.
Комментарии
Дополнительные сведения о WdfIoTargetGetDevice см. в разделе Получение сведений об общем целевом объекте ввода-вывода.
Дополнительные сведения о целевых объектах ввода-вывода см. в разделе Использование целевых объектов ввода-вывода.
Примеры
В следующем примере кода показано, как функция обратного вызова EvtIoTargetQueryRemove может вызывать WdfIoTargetGetDevice.
NTSTATUS
MyEvtIoTargetQueryRemove(
WDFIOTARGET IoTarget
)
{
WDFDEVICE device;
...
device = WdfIoTargetGetDevice(IoTarget);
...
}
Требования
| Требование | Значение |
|---|---|
| Целевая платформа | Универсальное |
| Минимальная версия KMDF | 1,0 |
| Минимальная версия UMDF | 2,0 |
| Верхняя часть | wdfiotarget.h (включая Wdf.h) |
| Библиотека | Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF) |
| IRQL | <=DISPATCH_LEVEL |
| Правила соответствия DDI | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |