Microsoft Windows CE 3.0  

ACMDRVOPENDESC

Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.

This structure is used by the ACM for passing information to an ACM driver after the ACM sends the driver an ACM_Openfunction.

typedef struct {
DWORD
cbStruct
;
FOURCC
fccType
;
FOURCC
fccComp
;
DWORD
dwVersion
;
DWORD
dwFlags
;
DWORD
dwError
;
LPCSTR
pszSectionName
;
LPCSTR
pszAliasName
;
DWORD
dnDevNode
;
} ACMDRVOPENDESC;

Members

cbStruct
Specifies the size, in bytes, of the structure.
fccType
Contains a four-character code identifying the driver type. The driver must compare this value with ACMDRIVERDETAILS_FCCTYPE_AUDIOCODEC, which is declared in the Msacm.h header file, to equal the string "audc". If the member contents do not match this string, the driver must fail the open request by specifying an ACM_IOControlreturn value of 0.
fccComp
Not used. Defined to contain a four-character code identifying the driver sub-type.
dwVersion
Specifies the ACM's version number. The version number format is 0xAABBCCCC, where AA is the major version number, BB is the minor version number, and CCCC is the build number. This value is also returned by the ACM's acmGetVersionfunction.
dwFlags
No flags currently are defined. This member is identical to the fdwOpenargument passed to the acmDriverOpenfunction.
dwError
Specifies an error value. Drivers are restricted to specifying an ACM_IOControlreturn value of 0 for all error types. To provide better error resolution, ACM drivers can specify an error value in this member if they set the ACM_IOControlfunction's return value to 0. The error value can be one of the MMSYSERR error values declared in the Mmsystem.h header file or one of the ACMERR error values declared in the Msacm.h header file.
pszSectionName
Pointer to the registry key under which the driver's alias is stored. For more information, see the Windows NT Device Driver Kit.
pszAliasName
Pointer to the driver's alias. This is the driver's Msacm. alias entry in the registry. For more information, see the Windows NT Device Driver Kit.
dnDevNode
Specifies a device node identifier.

Remarks

When the ACM calls an ACM driver's ACM_IOControlentry point and specifies a DRV_OPEN message, it includes an ACMDRVOPENDESCstructure as the lParam2member of ACM_IOControl. The ACM sends a DRV_OPEN message when an application calls the acmDriverOpenfunction.

Requirements

Runs on Versions Defined in Include Link to
Windows CE OS 1.0 and later Msacmdrv.h    
Note   This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.


 Last updated on Tuesday, July 13, 2004

© 2004 Microsoft Corporation. All rights reserved.