Funzione WdfChildListRequestChildEject (wdfchildlist.h)
[Si applica solo a KMDF]
Il metodo WdfChildListRequestChildEject informa il framework che un dispositivo specificato sta per essere espulso dalla sua stazione di ancoraggio.
Sintassi
BOOLEAN WdfChildListRequestChildEject(
[in] WDFCHILDLIST ChildList,
[in] PWDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER IdentificationDescription
);
Parametri
[in] ChildList
Handle per un oggetto elenco figlio.
[in] IdentificationDescription
Puntatore a una struttura WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER allocata dal chiamante.
Valore restituito
WdfChildListRequestChildEject restituisceTRUE se l'operazione ha esito positivo. Se un parametro di input non è valido o se il framework non riesce a trovare il dispositivo nell'elenco figlio, il metodo restituisce FALSE.
Un controllo dei bug di sistema si verifica se il driver fornisce un handle di oggetto non valido.
Commenti
Un autista del bus può chiamare WdfChildListRequestChildEject o WdfPdoRequestEject per segnalare che il driver ha rilevato un tentativo di espellere uno dei dispositivi figlio enumerati dalla stazione di ancoraggio del dispositivo. Ad esempio, il driver potrebbe rilevare che un utente ha premuto un pulsante di espulsione.
Se il driver usa l'enumerazione dinamica del bus e se la descrizione di identificazione del dispositivo è disponibile, il driver può chiamare WdfChildListRequestChildEject. Se l'oggetto dispositivo framework per il PDO del dispositivo è disponibile, il driver può chiamare WdfPdoRequestEject.
Il parametro IdentificationDescription del metodo WdfChildListRequestChildEject identifica il dispositivo che viene espulso. Il dispositivo deve essere un membro dell'elenco figlio rappresentato dal parametro ChildList .
Il framework usa la descrizione di identificazione per individuare il dispositivo nell'elenco figlio.
Per altre informazioni sugli elenchi figlio, vedere Enumerazione dinamica.
Per altre informazioni sui dispositivi espulibili, vedere Supporto di dispositivi eiettabili.
Esempio
Per un esempio di codice che usa WdfChildListRequestChildEject, vedere WdfChildListRetrieveNextDevice.
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Universale |
| Versione KMDF minima | 1.0 |
| Intestazione | wdfchildlist.h (include Wdf.h) |
| Libreria | Wdf01000.sys (vedere Controllo delle versioni della libreria framework). |
| IRQL | <= DISPATCH_LEVEL |
| Regole di conformità DDI | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |