Función WdfChildListUpdateChildDescriptionAsMissing (wdfchildlist.h)

  • Artículo

[Solo se aplica a KMDF]

El método WdfChildListUpdateChildDescriptionAsMissing informa al marco de trabajo de que un dispositivo secundario especificado está desconectado o no está 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 una descripción de identificación secundaria proporcionada por el controlador.

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 apunta IdentificationDescription era incorrecto.
STATUS_NO_SUCH_DEVICE
 El dispositivo especificado no se encontró en la lista secundaria.
 

Este método también podría devolver otros valores NTSTATUS.

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

Comentarios

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 de 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 Value
Plataforma de destino Universal
Versión mínima de KMDF 1.0
Encabezado wdfchildlist.h (incluya Wdf.h)
Library 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