UPnPAVError
A version of this page is also available for
4/8/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 |
| Windows Mobile | Windows Mobile Version 5.0 and later |