Função NfcCxHardwareEvent (nfccx.h)
Chamado pelo driver cliente quando ocorre um evento de hardware, como retornos de chamada D0Entry e D0Exit para iniciar ou parar o dispositivo. Para drivers que exigem o download de firmware na inicialização ou inicialização, é recomendável mover essa chamada para um item de trabalho separado. No entanto, o driver cliente é responsável pelo seguinte:
- O driver cliente deve usar uma referência de energia ociosa antes de enfileirar o item de trabalho. A referência precisa ser descartada quando o item de trabalho for concluído. Isso garante que o gerenciamento de energia ocioso não faça com que o driver entre em D3 enquanto o item de trabalho estiver em execução.
- O driver cliente deve sincronizar o item de trabalho com outros retornos de chamada do dispositivo. Isso normalmente é obtido pela opção AutomaticSerialization em WDF_WORKITEM_CONFIG e ter o pai do WDFWORKITEM ser o WDFDEVICE ou ter o retorno de chamada do item de trabalho explicitamente tomando o bloqueio do dispositivo, ou seja, WdfObjectAcquireLock no WDFDEVICE.
- Se a chamada de evento de hardware falhar em um item de trabalho, o driver cliente deverá reiniciar ou desbloquear o driver para impedir que ele esteja em um estado incorreto. Isso pode ser obtido usando a opção Reiniciar ou Descarregar.
Sintaxe
NTSTATUS NfcCxHardwareEvent(
WDFDEVICE Device,
PNFC_CX_HARDWARE_EVENT HardwareEvent
);
Parâmetros
Device
Um identificador para um objeto de dispositivo de estrutura.
HardwareEvent
Um ponteiro para uma estrutura NFC_CX_HARDWARE_EVENT.
Valor de retorno
Se a operação for bem-sucedida, a função retornará STATUS_SUCCESS.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Windows 10 |
| servidor com suporte mínimo | Nenhum com suporte |
| da Plataforma de Destino |
Windows |
| cabeçalho | nfccx.h (inclua Ncidef.h) |
| biblioteca | Nfccxstub.lib |
| de DLL |
NfcCx.dll |