NfcCxHardwareEvent 함수(nfccx.h)

  • 아티클

디바이스를 시작하거나 중지하기 위해 D0Entry 및 D0Exit 콜백과 같은 하드웨어 이벤트가 발생할 때 클라이언트 드라이버에서 호출됩니다. 초기화 또는 부팅 시 펌웨어 다운로드가 필요한 드라이버의 경우 이 호출을 별도의 작업 항목으로 이동하는 것이 좋습니다. 그러나 클라이언트 드라이버는 다음을 담당합니다.

  • 클라이언트 드라이버는 작업 항목을 큐에 넣기 전에 유휴 전원 참조를 사용해야 합니다. 작업 항목이 완료되면 참조를 삭제해야 합니다. 이렇게 하면 작업 항목이 실행되는 동안 유휴 전원 관리로 인해 드라이버가 D3으로 이동하지 않습니다.
  • 클라이언트 드라이버는 작업 항목을 다른 디바이스 콜백과 동기화해야 합니다. 이는 일반적으로 WDF_WORKITEM_CONFIG AutomaticSerialization 옵션에 의해 수행되며 WDFWORKITEM의 부모가 WDFDEVICE이거나 WDFDEVICE의 WdfObjectAcquireLock 과 같이 디바이스 잠금을 명시적으로 사용하는 작업 항목 콜백이 있어야 합니다.
  • 작업 항목에서 하드웨어 이벤트 호출이 실패하는 경우 클라이언트 드라이버는 드라이버를 다시 시작하거나 잠금을 해제하여 잘못된 상태가 되지 않도록 해야 합니다. 다시 시작 또는 언로드 옵션을 사용하여 이 작업을 수행할 수 있습니다.

구문

NTSTATUS NfcCxHardwareEvent(
  WDFDEVICE              Device,
  PNFC_CX_HARDWARE_EVENT HardwareEvent
);

매개 변수

Device

프레임워크 디바이스 개체에 대한 핸들입니다.

HardwareEvent

NFC_CX_HARDWARE_EVENT 구조체에 대한 포인터입니다.

반환 값

작업이 성공하면 함수는 STATUS_SUCCESS 반환합니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 10
지원되는 최소 서버 지원되는 버전 없음
대상 플랫폼 Windows
헤더 nfccx.h(Ncidef.h 포함)
라이브러리 Nfccxstub.lib
DLL NfcCx.dll

추가 정보

NFC 클래스 확장 디자인 가이드

NFC(근거리 통신) 디자인 가이드