EVT_WDF_DEVICE_SET_LOCK funzione di callback (wdfpdo.h)
[Si applica solo a KMDF]
La funzione di callback dell'evento EvtDeviceSetLock di un driver blocca il dispositivo specificato in modo che non possa essere espulso o sblocca il dispositivo in modo che possa essere espulso.
Sintassi
EVT_WDF_DEVICE_SET_LOCK EvtWdfDeviceSetLock;
NTSTATUS EvtWdfDeviceSetLock(
[in] WDFDEVICE Device,
[in] BOOLEAN IsLocked
)
{...}
Parametri
[in] Device
Handle per un oggetto dispositivo framework.
[in] IsLocked
Valore booleano che indica se il driver deve bloccare o sbloccare il dispositivo. Se TRUE, il driver deve bloccare il dispositivo in modo che non possa essere espulso. Se FALSE, il driver deve sbloccare il dispositivo in modo che possa essere espulso.
Valore restituito
Se il driver blocca o sblocca correttamente il dispositivo, deve restituire STATUS_SUCCESS. In caso contrario, deve restituire un valore NTSTATUS che NT_SUCCESS restituisce FALSE.
Per altre informazioni sui valori restituiti di questa funzione di callback, vedere Segnalazione di errori del dispositivo.
Commenti
I driver bus basati su framework possono fornire una funzione di callback EvtDeviceSetLock . Per registrare questa funzione di callback, i driver del bus chiamano WdfPdoInitSetEventCallbacks.
Il framework chiama la funzione di callback EvtDeviceSetLock del driver quando il gestore PnP richiede al driver del bus di bloccare o sbloccare uno dei dispositivi figlio enumerati.
L'implementazione di una funzione di callback EvtDeviceSetLock per un dispositivo equivale a restituire un valore NTSTATUS che restituisce FALSE.
Per altre informazioni sui valori restituiti, vedere Supporto di dispositivi eiettabili.
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Universale |
| Versione KMDF minima | 1,0 |
| Intestazione | wdfpdo.h (include Wdf.h) |
| IRQL | PASSIVE_LEVEL |