Función WdfChildListUpdateChildDescriptionAsMissing (wdfchildlist.h)

[Solo se aplica a KMDF]

El método WdfChildListUpdateChildDescriptionAsMissing informa al marco de trabajo de que un dispositivo secundario especificado está actualmente desconectado o no disponible.

Sintaxis

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

Parámetros

[in] ChildList

Identificador de un objeto de lista secundario.

[in] IdentificationDescription

Puntero a una estructura de WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER asignada por el autor de la llamada que identifica un elemento secundario proporcionado por el controlador descripción de identificación.

Valor devuelto

WdfChildListUpdateChildDescriptionAsMissing devuelve STATUS_SUCCESS, u otro valor de estado para el que NT_SUCCESS(status) es igual a TRUE, si la operación se realiza correctamente. De lo contrario, este método podría devolver uno de los siguientes valores:

Código devuelto	Descripción
STATUS_INVALID_PARAMETER	Un parámetro de entrada no era válido.
STATUS_INVALID_DEVICE_REQUEST	El tamaño de la estructura a la que IdentificationDescription apunta a era incorrecto.
STATUS_NO_SUCH_DEVICE	El dispositivo especificado no se encontró en la lista secundaria.

 

Este método también puede devolver otros valores de NTSTATUS.

Se produce una comprobación de errores del sistema si el controlador proporciona un identificador de objeto no válido.

Observaciones

El controlador puede informar de que un dispositivo no está disponible incluso si el controlador nunca llamó a WdfChildListAddOrUpdateChildDescriptionAsPresent para informar de que el dispositivo estaba presente. En este caso, el método WdfChildListUpdateChildDescriptionAsMissing simplemente devuelve STATUS_NO_SUCH_DEVICE.

Si desea informar de que todos los dispositivos de una lista secundaria no están disponibles, el controlador simplemente puede llamar a WdfChildListBeginScan, seguido inmediatamente de WdfChildListEndScan, en lugar de llamar a WdfChildListUpdateChildDescriptionAsMissing para cada dispositivo.

Para obtener más información sobre los dispositivos secundarios y las listas secundarias, vea enumeración dinámica.

Ejemplos

En el ejemplo de código siguiente se informa al marco de trabajo que un dispositivo secundario con un número de serie especificado no está disponible.

PDO_IDENTIFICATION_DESCRIPTION  description;
NTSTATUS  status;

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

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

Requisitos

Requisito	Valor
de la plataforma de destino de	Universal
versión mínima de KMDF	1.0
encabezado de	wdfchildlist.h (incluya Wdf.h)
biblioteca de	Wdf01000.sys (consulte Control de versiones de la biblioteca de marcos).
irQL	<= DISPATCH_LEVEL
reglas de cumplimiento de DDI	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Consulte también

WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER

WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER_INIT

WdfChildListAddOrUpdateChildDescriptionAsPresent