IOCTL_IR_GET_EMITTERS control code

Important

The Infrared driver stack is deprecated starting in Windows 10, version 1803 and should no longer be used.

The IOCTL_IR_GET_EMITTERS request is used in the first run to identify how many emitters are connected to the system and which ports have emitters connected.

This request retrieves attached emitters and returns the information in a bitmask. This request needs to return timely information. The user will likely plug and unplug emitters during the operation of a computer, so the hardware must be queries at the time of the call.

Input Parameters

None.

Output Parameters

Irp->AssociatedIrp.SystemBuffer contains a pointer to a 32-bit value to be filled in with a bitmask that represents the attached emitters.

I/O Status Block

The Information field is set to sizeof(ULONG) if the operation is successful.

The Status field is set to STATUS_SUCCESS if the operation is completed successfully. It can also be the following value:

  • STATUS_BUFFER_TOO_SMALL
    The supplied output buffer is too small to be a ULONG.

Remarks

The IOCTL_IR_GET_EMITTERS IOCTL is available on x86-based and x64-based computers with the Windows Vista operating system.

Requirements

Header

Irclass_ioctl.h (include Irclass_ioctl.h)

Send comments about this topic to Microsoft