IAVTransport::InvokeVendorAction (Windows CE 5.0)
This method enables AVTransport implementations and users to provide and invoke custom vendor-specific actions that aren't defined in the AVTransport DCP.
virtual DWORD InvokeVendorAction( LPCWSTR pszActionName, DISPPARAMS* pdispparams, VARIANT* pvarResult) = 0;
Parameters
- pszActionName
[in] Name of the vendor-specific action. - pdispparams
[in] Pointer to a DISPPARAMS structure that contains input and/or output parameters used by the vendor-specific action. - pvarResult
[in, out] Pointer to a VARIANT that the implementation of this method can use to return the results of the specified action. Implementations can also use output parameters in the pdispparams parameter.
Return Values
Custom implementations can return appropriate error codes. Should return SUCCESS_AV if the method succeeds. Otherwise, should return an error code defined in WinError.h or UPnP.h, one of the UPnP AV-specific return values specified in UPnPAVError, or a custom error code defined by the action.
Remarks
Devices implement this method to provide custom vendor-specific actions. In addition to implementing this method, all of the other standard processes for extending UPnP DCPs should be followed, including updating the service description XML documents, and so on.
Control points call this method to invoke custom vendor-specific actions.
For more information about implementing and calling custom actions, see Implementing and Calling Custom Actions.
The AVTransport service does not require that this method be implemented. The IAVTransportImpl class therefore overrides this method to return ERROR_AV_UPNP_INVALID_ACTION.
For more information about implementing custom vendor-specific actions, see UPnP AV DCP Documentation.
Requirements
OS Versions: Windows CE 5.0 and later.
Header: Av_upnp.h.
Link Library: Av_upnp.lib.
C++ Namespace: av_upnp
See Also
IAVTransport | DISPPARAMS | IAVTransportImpl | VARIANT | UPnPAVError
Send Feedback on this topic to the authors