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