Функция WdfChildListRequestChildEject (wdfchildlist.h)

Статья
08/08/2023

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

Метод WdfChildListRequestChildEject информирует платформу о том, что указанное устройство будет извлечено из док-станции.

Синтаксис

BOOLEAN WdfChildListRequestChildEject(
  [in] WDFCHILDLIST                                 ChildList,
  [in] PWDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER IdentificationDescription
);

Параметры

[in] ChildList

Дескриптор дочернего объекта списка.

[in] IdentificationDescription

Указатель на структуру WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER , выделенную вызывающим объектом.

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

WdfChildListRequestChildEject возвращает значение TRUE , если операция выполнена успешно. Если входной параметр недопустим или платформа не может найти устройство в дочернем списке, метод возвращает значение FALSE.

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

Водитель автобуса может вызвать WdfChildListRequestChildEject или WdfPdoRequestEject , чтобы сообщить, что водитель обнаружил попытку извлечь одно из перечисленных дочерних устройств из док-станции устройства. Например, драйвер может обнаружить, что пользователь нажал кнопку извлечения.

Если драйвер использует динамическое перечисление шины и доступно описание идентификации устройства, драйвер может вызвать WdfChildListRequestChildEject. Если объект устройства платформы для PDO устройства доступен, драйвер может вызвать WdfPdoRequestEject.

Параметр IdentificationDescription метода WdfChildListRequestChildEject идентифицирует извлекаемое устройство. Устройство должно быть членом дочернего списка, который представляет параметр ChildList .

Платформа использует описание идентификации, чтобы найти устройство в дочернем списке.

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

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

Примеры

Пример кода, в котором используется WdfChildListRequestChildEject, см. в разделе WdfChildListRetrieveNextDevice.

Требования

Требование	Значение
Целевая платформа	Универсальное
Минимальная версия KMDF	1,0
Верхняя часть	wdfchildlist.h (включая Wdf.h)
Библиотека	Wdf01000.sys (см. раздел Управление версиями библиотеки платформы).
IRQL	<= DISPATCH_LEVEL
Правила соответствия DDI	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

См. также раздел

WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER

WdfPdoRequestEject

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