EVT_WDF_DEVICE_SET_LOCK funzione di callback (wdfpdo.h)

[Si applica solo a KMDF]

La funzione di callback di un driver EvtDeviceSetLock blocca il dispositivo specificato in modo che non possa essere espulso o sblocca il dispositivo in modo che possa essere inserito.

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 valuta come FALSE.

Per altre informazioni sui valori restituiti di questa funzione di callback, vedere Segnalazione errori del dispositivo.

Osservazioni:

I driver del 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 il driver EvtDeviceSetLock funzione di callback quando il gestore PnP richiede al driver del bus di bloccare o sbloccare uno dei dispositivi figlio enumerati.

L'implementazione di un EvtDeviceSetLock funzione di callback 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 minima di KMDF	1.0
intestazione	wdfpdo.h (include Wdf.h)
IRQL	PASSIVE_LEVEL

Vedere anche

EvtDeviceEject