OpenAL Specification and Reference
<<< PreviousExtensionsNext >>>

Retrieving Enumeration Values

To obtain enumeration values for extensions, the application has to use GetEnumValue of an extension token. Enumeration values are defined within the AL namespace and allocated according to specification of the core API and the extensions, thus they are context-independent.

uint GetEnumValue ( const ubyte enumName );

Returns 0 if the enumeration can not be found. The presence of an enum value does not guarantee the applicability of an extension to the current context. A non-zero return indicates merely that the implementation is aware of the existence of this extension. Implementations should not attempt to return 0 to indicate that the extensions is not supported for the current context.

NoteAnnotation/ enums with value zero
 

The literal value 0 is guaranteed for a number of AL enums, such as FALSE, NONE, ZERO. As with GL applications might employ sloppy use of this identity. It also means that enums with zero value can not be queried through GetEnumValue, a minor flaw given the constraints of ABI backward compatibility. The recommended value to compare GetEnumValue results with is NONE.

<<< PreviousHomeNext >>>
Retrieving Function Entry AddressesUpNaming Conventions