WdfChildListRequestChildEject-Funktion (wdfchildlist.h)
[Gilt nur für KMDF]
Die WdfChildListRequestChildEject Methode informiert das Framework, dass ein angegebenes Gerät von seiner Dockingstation ausgeworfen werden soll.
Syntax
BOOLEAN WdfChildListRequestChildEject(
[in] WDFCHILDLIST ChildList,
[in] PWDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER IdentificationDescription
);
Parameter
[in] ChildList
Ein Handle zu einem untergeordneten Listenobjekt.
[in] IdentificationDescription
Ein Zeiger auf eine aufrufergeteilte WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER Struktur.
Rückgabewert
WdfChildListRequestChildEject gibt TRUE zurück, wenn der Vorgang erfolgreich ist. Wenn ein Eingabeparameter ungültig ist oder das Framework das Gerät in der untergeordneten Liste nicht finden kann, gibt die Methode FALSEzurück.
Eine Systemfehlerüberprüfung tritt auf, wenn der Treiber ein ungültiges Objekthandle bereitstellt.
Bemerkungen
Ein Bustreiber kann WdfChildListRequestChildEject oder WdfPdoRequestEject- aufrufen, um zu melden, dass der Treiber versucht hat, eines seiner aufgezählten untergeordneten Geräte von der Dockingstation des Geräts auszuwerfen. Beispielsweise kann der Treiber erkennen, dass ein Benutzer eine Auswerftaste gedrückt hat.
Wenn der Treiber dynamische Busenumeration verwendet und die Identifikationsbeschreibung des Geräts verfügbar ist, kann der Treiber WdfChildListRequestChildEjectaufrufen. Wenn das Framework-Geräteobjekt für die PDO des Geräts verfügbar ist, kann der Treiber WdfPdoRequestEjectaufrufen.
Der WdfChildListRequestChildEject Methode IdentificationDescription Parameter identifiziert das Gerät, das ausgeworfen wird. Das Gerät muss ein Mitglied der untergeordneten Liste sein, das der ChildList Parameter darstellt.
Das Framework verwendet die Identifikationsbeschreibung, um das Gerät in der untergeordneten Liste zu finden.
Weitere Informationen zu untergeordneten Listen finden Sie unter dynamische Enumeration.
Weitere Informationen zu auswerfbaren Geräten finden Sie unter Unterstützen von auswerfbaren Geräten.
Beispiele
Ein Codebeispiel, das WdfChildListRequestChildEject-verwendet, finden Sie unter WdfChildListRetrieveNextDevice.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform- | Universal |
| Minimale KMDF-Version | 1.0 |
| Header- | wdfchildlist.h (include Wdf.h) |
| Library | Wdf01000.sys (siehe Framework-Bibliotheksversionsverwaltung.) |
| IRQL- | <= DISPATCH_LEVEL |
| DDI-Complianceregeln | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |