Share via

UPnPAVError (Windows Embedded CE 6.0)

  • Article

1/6/2010

This enumeration represents UPnP AV Framework return values as well as errors defined by the UPnP AV DCP.

Most of these errors are useful in both control points and devices. A subset of errors are useful only on a UPnP AV control. These errors are marked below as control point-only errors.

All but one of the errors in this enumeration are errors explicitly returned by implementation code. ERROR_AV_UPNP_ERROR is an exception: this error is raised when a network communication or other undefined error occurs that prevents a control point from receiving a valid response from the device. You can use GetLastError to find more information about the specific problem that caused this error.

For more information about the error codes defined by the UPnP AV DCP, see UPnP AV DCP Documentation.

Syntax

enum UPnPAVError
{
    SUCCESS_AV                         = 0,
    // Internal AV Toolkit only errors
    ERROR_AV_POINTER                   = -1,
    ERROR_AV_OOM                       = -2,
    ERROR_AV_INVALID_INSTANCE          = -3,
    ERROR_AV_INVALID_STATEVAR          = -4,
    ERROR_AV_ALREADY_INITED            = -5,
    // Internal AV Toolkit Control Point errors
    ERROR_AV_NONEXISTANT_SERVICE       = -6,
    ERROR_AV_NO_MORE_ITEMS             = -7,
    ERROR_AV_UPNP_ERROR                = -8,
    ERROR_AV_INVALID_OUT_ARGUMENTS     = -9,
    // Standard UPnP Errors
    ERROR_AV_UPNP_INVALID_ACTION       = FAULT_INVALID_ACTION,
    ERROR_AV_UPNP_ACTION_FAILED        = FAULT_DEVICE_INTERNAL_ERROR,
    // ConnectionManager Errors
    ERROR_AV_UPNP_CM_INCOMPATIBLE_PROTOCOL                  = 701,
    ERROR_AV_UPNP_CM_INCOMPATIBLE_DIRECTION                 = 702,
    ERROR_AV_UPNP_CM_INSUFFICIENT_NET_RESOURCES             = 703,
    ERROR_AV_UPNP_CM_LOCAL_RESTRICTIONS                     = 704,
    ERROR_AV_UPNP_CM_ACCESS_DENIED                          = 705,
    ERROR_AV_UPNP_CM_INVALID_CONNECTION_REFERENCE           = 706,
    ERROR_AV_UPNP_CM_NOT_IN_NETWORK                         = 707,
    // AVTransport Errors
    ERROR_AV_UPNP_AVT_INVALID_TRANSITION                    = 701,
    ERROR_AV_UPNP_AVT_NO_CONTENTS                           = 702,
    ERROR_AV_UPNP_AVT_READ_ERROR                            = 703,
    ERROR_AV_UPNP_AVT_UNSUPPORTED_PLAY_FORMAT               = 704,
    ERROR_AV_UPNP_AVT_TRANSPORT_LOCKED                      = 705,
    ERROR_AV_UPNP_AVT_WRITE_ERROR                           = 706,
    ERROR_AV_UPNP_AVT_PROTECTED_MEDIA                       = 707,
    ERROR_AV_UPNP_AVT_UNSUPPORTED_REC_FORMAT                = 708,
    ERROR_AV_UPNP_AVT_FULL_MEDIA                            = 709,
    ERROR_AV_UPNP_AVT_UNSUPPORTED_SEEK_MODE                 = 710,
    ERROR_AV_UPNP_AVT_ILLEGAL_SEEK_TARGET                   = 711,
    ERROR_AV_UPNP_AVT_UNSUPPORTED_PLAY_MODE                 = 712,
    ERROR_AV_UPNP_AVT_UNSUPPORTED_REC_QUALITY               = 713,
    ERROR_AV_UPNP_AVT_ILLEGAL_MIME                          = 714,
    ERROR_AV_UPNP_AVT_CONTENT_BUSY                          = 715,
    ERROR_AV_UPNP_AVT_RESOURCE_NOT_FOUND                    = 716,
    ERROR_AV_UPNP_AVT_UNSUPPORTED_PLAY_SPEED                = 717,
    ERROR_AV_UPNP_AVT_INVALID_INSTANCE_ID                   = 718,
    // RenderingControl Errors
    ERROR_AV_UPNP_RC_INVALID_PRESET_NAME                    = 701,
    ERROR_AV_UPNP_RC_INVALID_INSTANCE_ID                    = 702,
    // ContentDirectory Errors
    ERROR_AV_UPNP_CD_NO_SUCH_OBJECT                         = 701,
    ERROR_AV_UPNP_CD_INVALID_CURRENTTAGVALUE                = 702,
    ERROR_AV_UPNP_CD_INVALID_NEWTAGVALUE                    = 703,
    ERROR_AV_UPNP_CD_REQUIRED_TAG_DELETE                    = 704,
    ERROR_AV_UPNP_CD_READONLY_TAG_UPDATE                    = 705,
    ERROR_AV_UPNP_CD_PARAMETER_NUM_MISMATCH                 = 706,
    ERROR_AV_UPNP_CD_BAD_SEARCH_CRITERIA                    = 708,
    ERROR_AV_UPNP_CD_BAD_SORT_CRITERIA                      = 709,
    ERROR_AV_UPNP_CD_NO_SUCH_CONTAINER                      = 710,
    ERROR_AV_UPNP_CD_RESTRICTED_OBJECT                      = 711,
    ERROR_AV_UPNP_CD_BAD_METADATA                           = 712,
    ERROR_AV_UPNP_CD_RESTRICTED_PARENT_OBJECT               = 713,
    ERROR_AV_UPNP_CD_NO_SUCH_SOURCE_RESOURCE                = 714,
    ERROR_AV_UPNP_CD_SOURCE_RESOURCE_ACCESS_DENIED          = 715,
    ERROR_AV_UPNP_CD_TRANSFER_BUSY                          = 716,
    ERROR_AV_UPNP_CD_NO_SUCH_FILE_TRANSFER                  = 717,
    ERROR_AV_UPNP_CD_NO_SUCH_DESTINATION_RESOURCE           = 718,
    ERROR_AV_UPNP_CD_DESTINATION_RESOURCE_ACCESS_DENIED     = 719,
    ERROR_AV_UPNP_CD_REQUEST_FAILED                         = 720
};

Elements

  • SUCCESS_AV
    Operation completed successfully.
  • ERROR_AV_POINTER
    At least one required pointer is NULL.
  • ERROR_AV_OOM
    Not enough memory was available to complete the operation.
  • ERROR_AV_INVALID_INSTANCE
    The instance ID or pointer was either non-existent (when required), or existed (when not required).
  • ERROR_AV_INVALID_STATEVAR
    The specified state variable name is not valid.
  • ERROR_AV_ALREADY_INITED
    This service class's Init method has already been called.
  • ERROR_AV_NONEXISTANT_SERVICE
    A required service does not exist on the device. Used only in UPnP AV control point applications.
  • ERROR_AV_NO_MORE_ITEMS
    There are no more items available in this set. Used only in UPnP AV control point applications.
  • ERROR_AV_UPNP_ERROR
    The UPnP Control Point API returned an error, probably because a network communication or other undefined error prevented a control point from receiving a valid response from the device. Use GetLastError to retrieve error details. Used only in UPnP AV control point applications.
  • ERROR_AV_INVALID_OUT_ARGUMENTS
    The specified action returned the wrong number and/or type of outgoing arguments. Used only in UPnP AV control point applications.
  • ERROR_AV_UPNP_INVALID_ACTION
    This service does not support the specified action. This is a standard UPnP error. Evaluates to 401.
  • ERROR_AV_UPNP_ACTION_FAILED
    The current service state prevents invocation of the specified action. This is a standard UPnP error. Evaluates to 501.
  • ERROR_AV_UPNP_CM_INCOMPATIBLE_PROTOCOL
    The protocol information is not valid. The connection cannot be established.
  • ERROR_AV_UPNP_CM_INCOMPATIBLE_DIRECTION
    The directions of the specified ConnectionManager instances are incompatible. The connection cannot be established.
  • ERROR_AV_UPNP_CM_INSUFFICIENT_NET_RESOURCES
    There are insufficient network resources to establish the connection.
  • ERROR_AV_UPNP_CM_LOCAL_RESTRICTIONS
    There are device-side limitations - transient or otherwise - that prevent the establishment of this connection.
  • ERROR_AV_UPNP_CM_ACCESS_DENIED
    The client is not allowed to access the specified ConnectionManager instance. The connection cannot be established.
  • ERROR_AV_UPNP_CM_INVALID_CONNECTION_REFERENCE
    The specified connection is not a valid connection established by this ConnectionManager instance.
  • ERROR_AV_UPNP_CM_NOT_IN_NETWORK
    The specified ConnectionManager instances are not part of the same network. The connection cannot be established.
  • ERROR_AV_UPNP_AVT_INVALID_TRANSITION
    The device does not support the transition to the specified transport state from the current transport state.
  • ERROR_AV_UPNP_AVT_NO_CONTENTS
    The current media contains no data to be played.
  • ERROR_AV_UPNP_AVT_READ_ERROR
    The current media cannot be played.
  • ERROR_AV_UPNP_AVT_UNSUPPORTED_PLAY_FORMAT
    This device does not support playback of the current media's storage format.
  • ERROR_AV_UPNP_AVT_TRANSPORT_LOCKED
    The transport is locked - usually by a hardware button on the device - and cannot be changed.
  • ERROR_AV_UPNP_AVT_WRITE_ERROR
    The current media cannot be written.
  • ERROR_AV_UPNP_AVT_PROTECTED_MEDIA
    The current media is write-protected or is not of a type that can be written.
  • ERROR_AV_UPNP_AVT_UNSUPPORTED_REC_FORMAT
    This device does not support recording to the storage format of the current media.
  • ERROR_AV_UPNP_AVT_FULL_MEDIA
    There is not enough free space on the current media for writing.
  • ERROR_AV_UPNP_AVT_UNSUPPORTED_SEEK_MODE
    The device does not support the specified seek mode.
  • ERROR_AV_UPNP_AVT_ILLEGAL_SEEK_TARGET
    The specified seek target is not valid for the specified seek mode, or is not present in the current media.
  • ERROR_AV_UPNP_AVT_UNSUPPORTED_PLAY_MODE
    The device does not support the specified play more.
  • ERROR_AV_UPNP_AVT_UNSUPPORTED_REC_QUALITY
    The device does not support the specified recording quality.
  • ERROR_AV_UPNP_AVT_ILLEGAL_MIME
    This AVTransport instance does not support the MIME type of the specified resource.
  • ERROR_AV_UPNP_AVT_CONTENT_BUSY
    The specified resource is already being output.
  • ERROR_AV_UPNP_AVT_RESOURCE_NOT_FOUND
    The specified resource cannot be located on the network.
  • ERROR_AV_UPNP_AVT_UNSUPPORTED_PLAY_SPEED
    This AVTransport instance does not support the specified play speed.
  • ERROR_AV_UPNP_AVT_INVALID_INSTANCE_ID
    The specified instance ID is invalid for this AVTransport instance.
  • ERROR_AV_UPNP_RC_INVALID_PRESET_NAME
    The specified name is not a valid preset name.
  • ERROR_AV_UPNP_RC_INVALID_INSTANCE_ID
    The specified RenderingControl instance ID is not valid.
  • ERROR_AV_UPNP_CD_NO_SUCH_OBJECT
    The specified object ID is not valid.
  • ERROR_AV_UPNP_CD_INVALID_CURRENTTAGVALUE
    The tag/value pair(s) specified in the CurrentTagValue parameter do not match the current ContentDirectory state. This can occur if the specified data is out of date.
  • ERROR_AV_UPNP_CD_INVALID_NEWTAGVALUE
    The tag value specified in the NewTagValue parameter is invalid.
  • ERROR_AV_UPNP_CD_REQUIRED_TAG_DELETE
    Required tags cannot be deleted.
  • ERROR_AV_UPNP_CD_READONLY_TAG_UPDATE
    Read-only tags cannot be changed.
  • ERROR_AV_UPNP_CD_PARAMETER_NUM_MISMATCH
    The number of tag/value pairs (including empty placeholders) in CurrentTagValue and NewTagValue do not match.
  • ERROR_AV_UPNP_CD_BAD_SEARCH_CRITERIA
    The specified search criteria is invalid or is not supported.
  • ERROR_AV_UPNP_CD_BAD_SORT_CRITERIA
    The specified sort criteria is invalid or is not supported.
  • ERROR_AV_UPNP_CD_NO_SUCH_CONTAINER
    The container specified by the ContainerID parameter is invalid or identifies an object that is not a container.
  • ERROR_AV_UPNP_CD_RESTRICTED_OBJECT
    The restricted attribute of the object is true. The operation failed.
  • ERROR_AV_UPNP_CD_BAD_METADATA
    The specified operation would create metadata that is invalid or not allowed. The operation failed.
  • ERROR_AV_UPNP_CD_RESTRICTED_PARENT_OBJECT
    The restricted attributed of the parent object is true. The operation failed.
  • ERROR_AV_UPNP_CD_NO_SUCH_SOURCE_RESOURCE
    The ContentDirectory instance cannot find the specified source resource.
  • ERROR_AV_UPNP_CD_SOURCE_RESOURCE_ACCESS_DENIED
    The ContentDirectory instance cannot access the specified source resource.
  • ERROR_AV_UPNP_CD_TRANSFER_BUSY
    The ContentDirectory instance cannot support another file transfer at this time.
  • ERROR_AV_UPNP_CD_NO_SUCH_FILE_TRANSFER
    The file transfer specified by the TransferID parameter does not exist.
  • ERROR_AV_UPNP_CD_NO_SUCH_DESTINATION_RESOURCE
    The ContentDirectory instance cannot find the specified destination resource.
  • ERROR_AV_UPNP_CD_DESTINATION_RESOURCE_ACCESS_DENIED
    The ContentDirectory instance cannot access the specified destination resource.
  • ERROR_AV_UPNP_CD_REQUEST_FAILED
    The ContentDirectory instance cannot process the request.

Requirements

Header av_upnp.h
Library Av_upnp.lib
Windows Embedded CE Windows CE 5.0 and later

See Also

Reference

UPnP AV Enumerations