Функция WdfPdoAddEjectionRelationsPhysicalDevice (wdfpdo.h)

Статья
03/22/2025

[Применимо только к KMDF]

Метод WdfPdoAddEjectionRelationsPhysicalDevice указывает, что указанное устройство удаляется при извлечении другого указанного устройства.

Синтаксис

NTSTATUS WdfPdoAddEjectionRelationsPhysicalDevice(
  [in] WDFDEVICE      Device,
  [in] PDEVICE_OBJECT PhysicalDevice
);

Параметры

[in] Device

Дескриптор объекта устройства платформы.

[in] PhysicalDevice

Указатель на предоставляемую вызывающим DEVICE_OBJECT структуру, представляющую объект физического устройства (PDO).

Возвращаемое значение

Если операция выполнена успешно, метод возвращает STATUS_SUCCESS. К дополнительным возвращаемым значениям относятся:

Код возврата	Описание
СТАТУС_НЕДЕЙСТВИТЕЛЬНЫЙ_ПАРАМЕТР	Входной параметр — NULL.
СТАТУС_НЕДОСТАТОЧНЫЕ_РЕСУРСЫ	Сбой выделения памяти.

Метод также может возвращать другие значения NTSTATUS.

Проверка системной ошибки возникает, если драйвер предоставляет недопустимый дескриптор объекта.

Замечания

Параметр PhysicalDevice указывает на PDO устройства, которое удаляется при извлечении устройства, определяемого устройством. Как правило, оба устройства управляются вызывающим драйвером. Не сообщайте дочерним устройствам устройства, так как при удалении родительского устройства диспетчер PnP также удаляет дочерние устройства.

Дополнительные сведения см. в поддержкедоступных для извлечения устройств.

Примеры

В следующем примере кода добавляется устройство, которое структура pPhysicalDeviceObject представляет список устройств, которые удаляются при извлечении устройства, устройства указывает.

PDEVICE_OBJECT  pPhysicalDeviceObject;
NTSTATUS  status;
...
status = WdfPdoAddEjectionRelationsPhysicalDevice(
 device,
 pPhysicalDeviceObject
                                                  );

Требования

Требование	Ценность
целевая платформа	универсальный
минимальная версия KMDF	1.0
Заголовок	wdfpdo.h (включая Wdf.h)
Библиотека	Wdf01000.sys (см. управление версиями библиотеки Платформы).)
IRQL	<= DISPATCH_LEVEL
правил соответствия DDI	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

См. также

WdfPdoClearEjectionRelationsDevices

WdfPdoRemoveEjectionRelationsPhysicalDevice

Поделиться через