WdfChildListRequestChildEject-Funktion (wdfchildlist.h)
[Gilt nur für KMDF]
Die WdfChildListRequestChildEject-Methode informiert das Framework darüber, dass ein angegebenes Gerät aus seiner Dockingstation ausgeworfen werden soll.
Syntax
BOOLEAN WdfChildListRequestChildEject(
[in] WDFCHILDLIST ChildList,
[in] PWDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER IdentificationDescription
);
Parameter
[in] ChildList
Ein Handle für ein untergeordnetes Listenobjekt.
[in] IdentificationDescription
Ein Zeiger auf eine aufruferseitig zugewiesene 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 nicht in der untergeordneten Liste finden kann, gibt die Methode FALSE zurück.
Eine Systemfehlerprüfung tritt auf, wenn der Treiber ein ungültiges Objekthandle bereitstellt.
Hinweise
Ein Bustreiber kann WdfChildListRequestChildEject oder WdfPdoRequestEject aufrufen, um zu melden, dass der Treiber einen Versuch erkannt hat, eines seiner aufgelisteten untergeordneten Geräte aus der Dockingstation des Geräts auszuwerfen. Beispielsweise erkennt der Treiber möglicherweise, dass ein Benutzer eine Auswurftaste gedrückt hat.
Wenn der Treiber die dynamische Busaufzählung verwendet und die Identifikationsbeschreibung des Geräts verfügbar ist, kann der Treiber WdfChildListRequestChildEject aufrufen. Wenn das Frameworkgeräteobjekt für die PDO des Geräts verfügbar ist, kann der Treiber WdfPdoRequestEject aufrufen.
Der IdentificationDescription-Parameter der WdfChildListRequestChildEject-Methode identifiziert das Gerät, das ausgeworfen wird. Das Gerät muss ein Mitglied der untergeordneten Liste sein, die der ChildList-Parameter darstellt.
Das Framework verwendet die Identifikationsbeschreibung, um das Gerät in der untergeordneten Liste zu suchen.
Weitere Informationen zu untergeordneten Listen finden Sie unter Dynamische Enumeration.
Weitere Informationen zu auswerfenden Geräten finden Sie unter Unterstützung auswerfender Geräte.
Beispiele
Ein Codebeispiel, das WdfChildListRequestChildEject verwendet, finden Sie unter WdfChildListRetrieveNextDevice.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Universell |
| KMDF-Mindestversion | 1.0 |
| Kopfzeile | wdfchildlist.h (einschließen von Wdf.h) |
| Bibliothek | Wdf01000.sys (siehe Versionierung der Frameworkbibliothek.) |
| IRQL | <= DISPATCH_LEVEL |
| DDI-Complianceregeln | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |