2.2.2.3.8 IOControl Reply Message
The client responds to the IOControl Request message from the server with this message.
|
|
|
|
|
|
|
|
|
|
1 |
|
|
|
|
|
|
|
|
|
2 |
|
|
|
|
|
|
|
|
|
3 |
|
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Header |
|||||||||||||||||||||||||||||||
|
Result |
|||||||||||||||||||||||||||||||
|
cbBytesReadReturned |
|||||||||||||||||||||||||||||||
|
Data (variable) |
|||||||||||||||||||||||||||||||
|
... |
|||||||||||||||||||||||||||||||
|
UnusedByte |
|||||||||||||||||||||||||||||||
Header (4 bytes): A CLIENT_IO_HEADER reply header. The PacketType field MUST be set to RESPONSE_PACKET (0x00). The RequestId field MUST match the value in the RequestId field in the corresponding IOControl Request message.
Result (4 bytes): An HRESULT value that specifies the result of the IOControl operation. There are no specific HRESULT values expected by this protocol, because the value is returned by the client-side device when it completes the IOControl request. An exception is the case when the DataOut field has an unexpected value, as described in section 2.2.2.3.7. The possible values will vary depending on the device.
cbBytesReadReturned (4 bytes): A 32-bit unsigned integer. This field specifies the size, in bytes, of data read from the client device. The value of this field MUST not exceed the value of the cbOut field in the IOControl Request Message (section 2.2.2.3.7).
Data (variable): A variable-length array of bytes. This field MUST contain the data returned by the client IOControl operation.
UnusedByte (1 byte): An 8-bit unsigned integer. This field is unused and MUST be ignored.