#include "ltmm.h"
C Syntax |
HRESULT IltmmWMProfile_getStreamByNumber(pProfile, StreamNum, pVal) |
C++ Syntax |
HRESULT GetStreamByNumber(StreamNum, pVal) |
IltmmWMProfile *pProfile; |
/* pointer to an interface */ |
long StreamNum; |
/* stream number */ |
IltmmWMStreamConfig **pVal; |
/* pointer to a pointer */ |
Gets the stream, with the specified number, in the profile.
Parameter |
Description |
pProfile |
Pointer to an IltmmWMProfile interface. |
StreamNum |
The number of the stream to retrieve. |
pVal |
Pointer to a variable to be updated with a pointer to an IltmmWMStreamConfig interface. This interface will reference the retrieved stream. |
Returns
S_OK |
The function was successful. |
<> S_OK |
An error occurred. Refer to the Error Codes or the HRESULT error codes in the DirectShow documentation. |
Comments
The stream number is different from the stream index. Stream indexes are zero-based, while each stream in the list might have its own number that is different from the index. If the function succeeds, the caller must free the retrieved interface by calling its Release function.
For more information, refer to the Microsoft documentation for IWMProfile::GetStreamByNumber .
Required DLLs and Libraries
LTMM For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application. |
Win32, x64
See Also
Example
For a C example, refer to IltmmWMProfile::GetStreamByNumber Example for C.
For a C++ example, refer to IltmmWMProfile::GetStreamByNumber Example for C++.