IOCTL_NFCSE_SUBSCRIBE_FOR_EVENT IOCTL (nfcsedev.h)
The IOCTL_NFCSE_SUBSCRIBE_FOR_EVENT control code is issued by a client to subscribe to a specific event.
Major code
Input buffer
SECURE_ELEMENT_EVENT_SUBSCRIPTION_INFO structure.
Output buffer
None
Status block
Irp->IoStatus.Status is set to STATUS_SUCCESS if the request is successful. Possible error codes are:
| Return Code | Description |
|---|---|
| STATUS_INVALID_DEVICE_STATE | This code is returned when this IOCTL is called on a device handle with a filename other than SEEvents, or there is already another pending request that is not completed yet. |
| STATUS_FEATURE_NOT_SUPPORTED | This code is returned when the output is non-zero, or when the GUID of the secure element does not match any of the enumerated IDs. |
Remarks
The following are requirements that the driver must adhere to.
- This IOCTL must be called on a handle with a SEEvents file name; otherwise, the driver returns STATUS_INVALID_DEVICE_STATE.
- GUID_NULL can be specified by the client as a wild card to subscribe for a specific event from all enumerated secure elements.
Requirements
| Requirement | Value |
|---|---|
| Header | nfcsedev.h |