Specifications
Remote Control and Receiver-Transceiver Specifications and Requirements
for Windows Media Center in Windows Operating Systems
156
The Information field is set to the actual number of bytes copied into the supplied data buffer,
including the IR_PRIORITY_RECEIVE_PARAMS structure.
The Status field is set to STATUS_SUCCESS if the operation is completed successfully. It may
also be one of the following values:
STATUS_INVALID_DEVICE_STATE - The device is not in Priority Receive mode.
STATUS_BUFFER_TOO_SMALL - The supplied output buffer is too small to be an
IR_PRIORITY_RECEIVE_PARAMS structure.
STATUS_INVALID_BUFFER_SIZE – The ByteCount field of the
IR_PRIORITY_RECEIVE_PARAMS structure is larger than the output buffer size specified in
the request.
For more information, see IR_PRIORITY_RECEIVE_PARAMS,
IOCTL_IR_ENTER_PRIORITY_RECEIVE, IOCTL_IR_EXIT_PRIORITY_RECEIVE, and
IOCTL_IR_RECEIVE.
IOCTL_IR_RECEIVE
User Scenario
Basic remote commands coming in from a remote control.
Operation
This request is sent from CIRClass and receives Run Length Coded (RLC) IR data when the
device is not running in Priority Receive mode. When running in Priority Receive mode, these
requests remain queued but receive no data.
An IOCTL_IR_RECEIVE request remains pending until one of two events occurs:
The data buffer provided in the request has been completely filled with RLC IR data.
An IR timeout occurs. In the case of an IR timeout, the DataEnd member of the output structure
is set to TRUE. The default timeout is 100 milliseconds.
Input
None.
Output
Irp->MdlAddress contains a variable length IR_RECEIVE_PARAMS structure.
I/O Status Block
The Information field is set to the actual number of bytes copied into the supplied data buffer,
including the IR_RECEIVE_PARAMS structure.
The Status field is set to STATUS_SUCCESS if the operation is completed successfully. It may
also be one of the following values:
STATUS_BUFFER_TOO_SMALL - The supplied output buffer is too small to be an
IR_RECEIVE_PARAMS structure.
STATUS_INVALID_BUFFER_SIZE – The ByteCount field of the IR_RECEIVE_PARAMS
structure is larger than the output buffer size specified in the request.
For more information, see IR_RECEIVE_PARAMS and IOCTL_IR_PRIORITY_RECEIVE.