Table of Contents

Index

NMS Glossary

Previous Page

Next Page

(Page 5 of 14 in this chapter) Version

mspDestroyChannel

Description

Destroys a specified MSPP media channel.

Prototype

DWORD mspDestroyChannel (MSPHD chnhd)
chnhd MSPP channel handle.

Return Values

SUCCESS
CTAERR_BAD_ARGUMENT
The function argument had an invalid value or a required pointer argument was NULL.
CTAERR_INVALID_CTAHD
The CTA context handle is invalid.
CTAERR_INVALID_HANDLE
An invalid handle was passed as an argument to this function.
MSPERR_INVALID_HANDLE
The specified MSPP channel is not valid.

Events

MSPEVN_DESTROY_CHANNEL_DONE
Generated when an MSPP media channel is destroyed following an mspDestroyChannel function call.The event.value field can contain the following:
SUCCESS
MSPRSN_FAILED_TO_DEALLOCATE
The MSPP service is unable to deallocate on-board resources.
MSPRSN_FAILED_TO_INTRADISCONNECT
The MSPP service is unable to disconnect filters within the channel.
MSPRSN_FAILED_TO_INTERDISCONNECT
The MSPP service is unable to disconnect the channel from an endpoint.

Details

When called, mspDestroyChannel disconnects and destroys the specified MSPP channel.

See Also

mspCreateChannel

Example


ret = mspDestroyChannel(hChan);
if (ret != SUCCESS)
    return FAILURE;
// Wait for event
ctaWaitEvent( hCta, &Event, CTA_WAIT_FOREVER );
// Check the reason code
if ( Event.id    != MSPEVN_DESTROY_CHANNEL_DONE ||
     Event.value != CTA_REASON_FINISHED )
    return FAILURE;

Table of Contents

Index

NMS Glossary

Previous Page

Next Page

(Page 5 of 14 in this chapter) Version

Want to send us feedback on our documentation? Email: Tech_Pubs@nmss.com

Copyright © 2000, Natural MicroSystems, Inc. All rights reserved.