ACMDRVSTREAMINSTANCE
This structure describes an instance of a conversion stream.
Syntax
typedef struct {
DWORD cbStruct;
LPWAVEFORMATEX pwfxSrc;
LPWAVEFORMATEX pwfxDst;
LPWAVEFILTER pwfltr;
DWORD dwCallback;
DWORD dwInstance;
DWORD fdwOpen;
DWORD fdwDriver;
DWORD dwDriver;
HACMSTREAM has;
} ACMDRVSTREAMINSTANCE;
Members
- cbStruct
- Specifies the size, in bytes, of the ACMDRVSTREAMINSTANCE structure.
- pwfxSrc
- Pointer to a WAVEFORMATEX structure that defines the source format for a conversion stream.
- pwfxDst
- Pointer to a WAVEFORMATEX structure that defines the destination format for a conversion stream.
- pwfltr
- Pointer to an optional WAVEFILTER structure that defines a filter to be used on a conversion stream. This member is NULL if the application has not specified a filter.
- dwCallback
- Specifies the application-specified dwCallback parameter of the acmStreamOpen function.
- dwInstance
- Specifies the application-specified dwInstance parameter of the acmStreamOpen function.
- fdwOpen
- Specifies the application-specified dwOpen parameter of the acmStreamOpen function, which consists of a set of flags.
- fdwDriver
- Specifies driver-defined stream instance information. While intended for storing flag values, an ACM driver can use this member to store any instance-specific DWORD value. Because the same ACMDRVSTREAMINSTANCE structure is passed with all stream messages associated with a particular stream instance, the stored value can be read or modified each time a stream message is received, and the last saved value is available the next time a stream message is received.
- dwDriver
- Specifies driver-defined stream instance information. An ACM driver can use this member for storing any instance-specific DWORD value, such as a pointer to a local, dynamically allocated structure. Because the same ACMDRVSTREAMINSTANCE structure is passed with all stream messages associated with a particular stream instance, the stored value can be read or modified each time a stream message is received, and the last saved value is available the next time a stream message is received.
- has
- Specifies the ACM-defined client handle to the open conversion stream.
Remarks
The ACM allocates this structure each time an application calls acmStreamOpen. This structure is then passed to the driver along with all stream messages associated with a particular stream instance. Information in this structure does not change, so if a driver validates information within this structure when it receives an ACMDM_STREAM_OPEN message, it does not have to validate the information again when it receives subsequent messages for the same stream instance.
This structure is declared in the Msacmdrv.h header file.