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

Статья
02/29/2024

[Относится только к 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(status) равно TRUE, если операция выполнена успешно. В противном случае этот метод может возвращать одно из следующих значений:

Код возврата	Описание
STATUS_INVALID_PARAMETER	Входной параметр был недопустимым.
STATUS_INVALID_DEVICE_REQUEST	Неправильный размер структуры, на которую указывает IdentificationDescription .
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

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