EVT_WDF_DEVICE_EJECT Rückruffunktion (wdfpdo.h)
[Gilt nur für KMDF]
Die EvtDeviceEject-Ereignisrückruffunktion eines Treibers verarbeitet Vorgänge, die zum Auswerfen eines Geräts aus der Dockingstation erforderlich sind.
Syntax
EVT_WDF_DEVICE_EJECT EvtWdfDeviceEject;
NTSTATUS EvtWdfDeviceEject(
[in] WDFDEVICE Device
)
{...}
Parameter
[in] Device
Ein Handle für ein Framework-Geräteobjekt.
Rückgabewert
Wenn der Vorgang erfolgreich ist, muss der Treiber STATUS_SUCCESS zurückgeben. Andernfalls muss ein NTSTATUS-Wert zurückgegeben werden, der NT_SUCCESS als FALSE auswertet. Geben Sie keine STATUS_NOT_SUPPORTED zurück.
Weitere Informationen zu Rückgabewerten finden Sie unter Melden von Gerätefehlern.
Hinweise
Frameworkbasierte Bustreiber können eine EvtDeviceEject-Rückruffunktion bereitstellen. Ein Bustreiber muss eine EvtDeviceEject-Rückruffunktion bereitstellen, wenn der Treiber Vorgänge ausführen muss, die eines seiner aufgelisteten untergeordneten Geräte physisch von der Dockingstation des Geräts auswerfen. Um diese Rückruffunktion zu registrieren, muss der Bustreiber WdfPdoInitSetEventCallbacks aufrufen.
Vor dem Aufrufen der Rückruffunktion EvtDeviceEject ruft das Framework die Rückruffunktionen EvtDeviceD0Exit und EvtDeviceReleaseHardware des Treibers auf.
Wenn die EvtDeviceEject-Rückruffunktion eines Treibers STATUS_SUCCESS zurückgibt, aktualisiert das Framework die untergeordnete Liste des Treibers, um anzugeben, dass das ausgeworfene Gerät nicht mehr verfügbar ist. Daher muss der Treiber WdfPdoMarkMissing oder WdfChildListUpdateChildDescriptionAsMissing nicht aufrufen.
Weitere Informationen zum Geräteauswurf finden Sie unter Unterstützung auswerfender Geräte.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Universell |
| KMDF-Mindestversion | 1.0 |
| Kopfzeile | wdfpdo.h (einschließen von Wdf.h) |
| IRQL | PASSIVE_LEVEL |