AVIStreamOpenFromFile
The AVIStreamOpenFromFile
function opens a single stream from a file.
STDAPI AVIStreamOpenFromFile(
|
PAVISTREAM
* ppavi, |
|
|
LPCTSTR szFile, |
|
|
DWORD fccType, |
|
|
LONG lParam, |
|
|
UINT mode, |
|
|
CLSID * pclsidHandler |
|
|
); |
|
Parameters
ppavi
Address to
contain the new stream handle.
szFile
Null-terminated
string containing the name of the file to open.
fccType
Four-character
code indicating the type of stream to be opened. Zero indicates that any stream
can be opened. The following definitions apply to the data commonly found in
AVI streams:
|
streamtypeAUDIO |
Indicates
an audio stream. |
|
streamtypeMIDI |
Indicates a
MIDI stream. |
|
streamtypeTEXT |
Indicates a
text stream. |
|
streamtypeVIDEO |
Indicates a
video stream. |
lParam
Stream of the
type specified in fccType to access. This parameter is zero-based; use
zero to specify the first occurrence.
mode
Access mode
to use when opening the file. This function can open only existing streams, so
the OF_CREATE mode flag cannot be used. For more information about the
available flags for the mode parameter, see the OpenFile
function.
pclsidHandler
Address of a
class identifier of the handler you want to use. If the value is NULL, the
system chooses one from the registry based on the file extension or the file
RIFF type.
Return Values
Returns zero
if successful or an error otherwise.
Remarks
This function
calls the AVIFileOpen, AVIFileGetStream, and AVIFileRelease
functions.
See Also