Funzione NfcCxHardwareEvent (nfccx.h)
Chiamato dal driver client quando si verifica un evento hardware come I callback D0Entry e D0Exit per avviare o arrestare il dispositivo. Per i driver che richiedono il download del firmware durante l'inizializzazione o l'avvio, è consigliabile spostare questa chiamata a un elemento di lavoro separato. Tuttavia, il driver client è responsabile dei seguenti elementi:
- Il driver client deve accettare un riferimento di alimentazione inattiva prima di accodare l'elemento di lavoro. Il riferimento deve essere eliminato al termine dell'elemento di lavoro. Ciò garantisce che il risparmio energia inattiva non causi l'ingresso del driver in D3 mentre l'elemento di lavoro è in esecuzione.
- Il driver client deve sincronizzare l'elemento di lavoro con altri callback del dispositivo. Questo risultato viene in genere ottenuto dall'opzione AutomaticSerialization in WDF_WORKITEM_CONFIG e avere l'elemento padre di WDFWORKITEM come WDFDEVICE o con il callback dell'elemento di lavoro che accetta esplicitamente il blocco del dispositivo, ad esempio WdfObjectAcquireLock in WDFDEVICE.
- Se la chiamata all'evento hardware non riesce da un elemento di lavoro, il driver client deve riavviare o sbloccare il driver per evitare che si verifichi uno stato non valido. A tale scopo, è possibile usare l'opzione Riavvia o Scarica.
Sintassi
NTSTATUS NfcCxHardwareEvent(
WDFDEVICE Device,
PNFC_CX_HARDWARE_EVENT HardwareEvent
);
Parametri
Device
Handle per un oggetto dispositivo framework.
HardwareEvent
Puntatore a una struttura NFC_CX_HARDWARE_EVENT.
Valore restituito
Se l'operazione ha esito positivo, la funzione restituisce STATUS_SUCCESS.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Windows 10 |
| server minimo supportato | Nessuna supportata |
| piattaforma di destinazione | Finestre |
| intestazione |
nfccx.h (include Ncidef.h) |
| libreria |
Nfccxstub.lib |
| dll | NfcCx.dll |