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) |