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

Статья
02/07/2025

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

Метод WdfChildListUpdateChildDescriptionAsMissing сообщает платформе, что указанное дочернее устройство в настоящее время неактивно или иначе недоступно.

Синтаксис

NTSTATUS WdfChildListUpdateChildDescriptionAsMissing(
  [in] WDFCHILDLIST                                 ChildList,
  [in] PWDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER IdentificationDescription
);

Параметры

[in] ChildList

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

[in] IdentificationDescription

Указатель на структуру, выделенную вызывающим WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER, которая идентифицирует дочернее идентификатора драйвера.

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

WdfChildListUpdateChildDescriptionAsMissing возвращает STATUS_SUCCESS или другое значение состояния, для которого NT_SUCCESS(состояние) равно TRUE, если операция завершается успешно. В противном случае этот метод может вернуть одно из следующих значений:

Возвращаемый код	Описание
STATUS_INVALID_PARAMETER	Недопустимый входной параметр.
STATUS_INVALID_DEVICE_REQUEST	Неправильный размер структуры, Идентификатор идентификации.
STATUS_NO_SUCH_DEVICE	Указанное устройство не найдено в дочернем списке.

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

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

Замечания

Драйвер может сообщить, что устройство недоступно, даже если драйвер никогда не вызывал WdfChildListAddOrUpdateChildDescriptionAsPresent сообщить о наличии устройства. В этом случае метод WdfChildListUpdateChildDescriptionAsMissing просто возвращает STATUS_NO_SUCH_DEVICE.

Если вы хотите сообщить, что все устройства в дочернем списке недоступны, драйвер может просто вызывать WdfChildListBeginScan, а затем сразу же WdfChildListEndScanвместо вызова WdfChildListUpdateChildDescriptionAsMissing для каждого устройства.

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

Примеры

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

PDO_IDENTIFICATION_DESCRIPTION  description;
NTSTATUS  status;

WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER_INIT(
                                                 &description.Header,
                                                 sizeof(description)
                                                 );

description.SerialNo = SerialNo;
status = WdfChildListUpdateChildDescriptionAsMissing(
                                                     list,
                                                     &description.Header
                                                     );

Требования

Требование	Ценность
целевая платформа	Всеобщий
минимальная версия 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

WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER_INIT

WdfChildListAddOrUpdateChildDescriptionAsPresent

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