IOCTL_NFCRM_SET_RADIO_STATE IOCTL(nfcradiodev.h)
이 IOCTL은 무선 관리 애플리케이션 또는 서비스에서 근접 디바이스의 무선 전원 상태를 설정하는 데 사용됩니다. MediaRadioOn 필드는 요청 전원 상태를 나타내는 데 사용됩니다. 근접 무선 전원 상태를 사용하지 않도록 설정하면 드라이버는 근접 디바이스 인터페이스(GUID_DEVINTERFACE_NFP 및 GUID_DEVINTERFACE_SMARTCARD_READER 인터페이스)를 사용하지 않도록 설정하고 디바이스의 P2P 및 판독기/기록기 모드를 사용하지 않도록 설정해야 합니다. 근접 무선 전원 상태를 사용하는 경우 드라이버는 근접 디바이스 인터페이스를 사용하도록 설정하고 컨트롤러의 P2P 및 판독기/기록기 모드를 사용하도록 설정해야 합니다. 이 디바이스에서 전원 모드를 최적화하는 방법에 대한 자세한 내용은 NFC 전원 관리를 참조하세요.
주 코드
입력 버퍼
입력 버퍼 길이
sizeof(NFCRM_SET_RADIO_STATE)
출력 버퍼
없음
출력 버퍼 길이
없음
상태 블록
Irp->요청이 성공하면 IoStatus.Status 가 STATUS_SUCCESS 설정됩니다. 가능한 오류 코드는 다음과 같습니다.
| 반환 코드 | Description |
|---|---|
| STATUS_INVALID_DEVICE_STATE | 이 코드는 디바이스가 클라이언트에서 설정 중인 근접 무선 전원 상태일 때 반환됩니다. |
설명
STATUS_INVALID_PARAMETER 반환 코드는 더 이상 필요하지 않습니다. Windows 10 빌드 10240에서 Windows가 이 IOCTL을 사용하여 null이 아닌 출력 매개 변수를 보내는 버그가 발견되었습니다. 이 버그는 이후 버전의 Windows에서 수정되었습니다. 코드를 간소화하기 위해 드라이버는 모든 버전의 Windows 10 출력 매개 변수를 무시할 수 있습니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 헤더 | nfcradiodev.h |