2.2.1.2 microsoft_teardown_reason

  • Article

The microsoft_teardown_reason parameter is included in the message body of the M8 message ([WF-DTS2.1] section 6.4.8) when the Wi-Fi Display Sink sets the diagnostics-capability parameter of the microsoft_diagnostics_capability parameter (section 2.2.1.1) to "supported".

The ABNF syntax is as follows:

    microsoft-teardown-reason = "microsoft_teardown_reason:" SP error-code SP error-reason             CRLF
    error-code = 8*8HEXDIG
    error-reason = *VCHAR

The 8 hexadecimal digit value of the error-code parameter is an HRESULT value as specified in [MS-ERREF] section 2.1. The following predefined error codes SHOULD be preferred over custom error codes when the reason for the failure applies.

Return value/code

Failure condition

MF_E_CANNOT_PARSE_BYTESTREAM

C00D36F0

Cannot parse byte stream; the incoming data is not a valid MPEG-2 stream.

MF_E_INVALID_FORMAT

C00D3E8C

The stream is valid, but the format (resolution, frame rate, channel count, and so on) cannot be handled.

MF_E_TRANSFORM_CANNOT_CHANGE_MEDIATYPE_WHILE_PROCESSING

C00D6D74

The format of the H.264, AAC, or AC3 [ITU-H.264-201201] bit streams changed, but the change cannot be handled.

MF_E_INVALID_STREAM_DATA

C00D36CB

The H.264, AAC, or AC3 bit stream is not valid and cannot be decoded.

MF_E_NET_TIMEOUT

C00D4278

The Wi-Fi Display Sink timed out waiting for a keep-alive or RTP data.

MF_E_INVALID_TIMESTAMP

C00D36C0

The presentation time stamps in the MPEG-2 Packetized Elementary Stream packets are corrupted, and the Wi-Fi Display Sink can no longer render the stream.

If the Wi-Fi Display Sink encounters an error that does not correspond to any of the failure conditions in the previous table, it SHOULD use a custom error code. A custom error code MUST NOT be any of the predefined error codes, and MUST set the C bit (0x20000000) for each vendor-defined value, indicating the value as a customer code.

Error reasons are implementation-defined and provide a human-readable explanation of the error condition. A Wi-Fi Display Source vendor and a Wi-Fi Display Sink vendor working together can use the error reason to identify and potentially correct the error condition.