Funzione NfcCxHardwareEvent (nfccx.h)
Chiamato dal driver client quando si verifica un evento hardware come D0Entry e D0Exit callback per avviare o arrestare il dispositivo. Per i driver che richiedono il download del firmware all'inizializzazione o all'avvio, è consigliabile spostare questa chiamata in 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 che il driver entri in D3 mentre l'elemento di lavoro è in esecuzione.
- Il driver client deve sincronizzare l'elemento di lavoro con altri callback del dispositivo. Questa operazione viene in genere ottenuta tramite l'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 in modo esplicito il blocco del dispositivo, ad esempio WdfObjectAcquireLock sul WDFDEVICE.
- Se la chiamata all'evento hardware non riesce da un elemento di lavoro, il driver client deve riavviare o sbloccare il driver per impedire 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.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 10 |
| Server minimo supportato | Nessuno supportato |
| Piattaforma di destinazione | Windows |
| Intestazione | nfccx.h (include Ncidef.h) |
| Libreria | Nfccxstub.lib |
| DLL | NfcCx.dll |