EVT_WDF_DEVICE_SET_LOCK Rückruffunktion (wdfpdo.h)
[Gilt nur für KMDF]
Die EvtDeviceSetLock-Ereignisrückruffunktion eines Treibers sperrt das angegebene Gerät, sodass es nicht ausgeworfen werden kann, oder entsperrt das Gerät, sodass es ausgeworfen werden kann.
Syntax
EVT_WDF_DEVICE_SET_LOCK EvtWdfDeviceSetLock;
NTSTATUS EvtWdfDeviceSetLock(
[in] WDFDEVICE Device,
[in] BOOLEAN IsLocked
)
{...}
Parameter
[in] Device
Ein Handle für ein Framework-Geräteobjekt.
[in] IsLocked
Ein boolescher Wert, der angibt, ob der Treiber das Gerät sperren oder entsperren muss. Bei TRUE muss der Treiber das Gerät sperren, damit es nicht ausgeworfen werden kann. Bei FALSE muss der Treiber das Gerät entsperren, damit es ausgeworfen werden kann.
Rückgabewert
Wenn der Treiber das Gerät erfolgreich sperrt oder entsperrt, muss es STATUS_SUCCESS zurückgeben. Andernfalls muss ein NTSTATUS-Wert zurückgegeben werden, der NT_SUCCESS als FALSE auswertet.
Weitere Informationen zu den Rückgabewerten dieser Rückruffunktion finden Sie unter Melden von Gerätefehlern.
Hinweise
Frameworkbasierte Bustreiber können eine EvtDeviceSetLock-Rückruffunktion bereitstellen. Um diese Rückruffunktion zu registrieren, rufen Bustreiber WdfPdoInitSetEventCallbacks auf.
Das Framework ruft die EvtDeviceSetLock-Rückruffunktion des Treibers auf, wenn der PnP-Manager den Bustreiber auffordert, eines seiner aufgelisteten untergeordneten Geräte zu sperren oder zu entsperren.
Die Implementierung einer EvtDeviceSetLock-Rückruffunktion für ein Gerät entspricht der Rückgabe eines NTSTATUS-Werts, der als FALSE ausgewertet wird.
Weitere Informationen zu Rückgabewerten 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 |