Función WdfChildListRequestChildEject (wdfchildlist.h)

[Solo se aplica a KMDF]

El método WdfChildListRequestChildEject informa al marco de trabajo que un dispositivo especificado está a punto de expulsarse de su estación de acoplamiento.

Sintaxis

BOOLEAN WdfChildListRequestChildEject(
  [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.

Valor devuelto

WdfChildListRequestChildEject devuelve TRUE si la operación se realiza correctamente. Si un parámetro de entrada no es válido o si el marco no encuentra el dispositivo en la lista secundaria, el método devuelve FALSE.

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

Comentarios

Un controlador de autobús puede llamar a WdfChildListRequestChildEject o WdfPdoRequestEject para informar de que el controlador ha detectado un intento de expulsar uno de sus dispositivos secundarios enumerados desde la estación de acoplamiento del dispositivo. Por ejemplo, el controlador podría detectar que un usuario ha presionado un botón de expulsión.

Si el controlador usa la enumeración de bus dinámico y si la descripción de identificación del dispositivo está disponible, el controlador puede llamar a WdfChildListRequestChildEject. Si el objeto de dispositivo de marco para el PDO del dispositivo está disponible, el controlador puede llamar a WdfPdoRequestEject.

El parámetro IdentificationDescription del método WdfChildListRequestChildEject identifica el dispositivo que se va a expulsar. El dispositivo debe ser miembro de la lista secundaria que representa el parámetro ChildList .

El marco usa la descripción de identificación para buscar el dispositivo en la lista secundaria.

Para obtener más información sobre las listas secundarias, vea Enumeración dinámica.

Para obtener más información sobre los dispositivos expulsables, consulte Compatibilidad con dispositivos expulsables.

Ejemplos

Para obtener un ejemplo de código que usa WdfChildListRequestChildEject, vea WdfChildListRetrieveNextDevice.

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

WdfPdoRequestEject