The COMPLETE Effect and HLSL Cross-Reference

By Sebastien St-Laurent
ISBN 0-9766132-1-2
Jan 2006 (896 pages)

Buy directly from Paradoxal Press at $20.75 (Save 43%)

Page 92

...emantics can easily be divided into four categories: vertex shader input, vertex shader output, pixel shader input and pixel shader output. Over the next few pages, I will present the four categories in a set of tables describing the semantics and their meaning. Keep in mind that in the tables below...

Page 31

...are generally used for vertex and pixel shader function inputs, mapping them to a speci.c meaning such as a vertex position or texture coordinate. For example, the COLOR0 semantic is used to tell the compiler that the speci.c variable is the . rst diffuse color which, on most shader versions, will g...

Page 154

...g that the name of the variable is now irrelevant to your application. Of course, this implies that your application sets its parameters based on the semantic of a variable instead of its name. This can easily be accomplished with the ID3DXEffect::GetParameterBySemantic function call. Below is the ...

Page 196

rcp Returns the reciprocal of the input, or 1/input. 1 Arithmetic

Page 182

...dle to the parameter for which you wish to verify the literal status. The literal status of the parameter will be put in the second parameter, pLiteral. Take note that this function only allows you to check if a parameter is a literal. To set the parameters value you will need to use one of the vari...

DirectXSetupGetEULA

Gets the DirectX end-user license agreement (EULA) text for a specific language.

int DirectXSetupGetEULA( LPTSTR 
    pszEULA, UINT cchEULA, WORD LangID
     );

Parameters

lpszEULA
[in] Points to a buffer that receives the EULA string. If the compiler settings require Unicode, the data type LPCTSTR resolves to LPCWSTR. Otherwise, the string data type resolves to LPCSTR. See Remarks.
cchEULA
[out] Specifies the size of the buffer pointed to by the lpszEULA parameter. If this value is zero, the function returns the required buffer size and makes no use of the lpszEULA buffer. If the compiler settings specify Unicode, the size is in Unicode characters, otherwise the size will be in ANSI characters.
LangID
[in] Determines in which language the DirectX EULA is returned. Specify 0 for the system default language. Or specify one of the following values.
MAKELANGID(LANG_CHINESE, SUBLANG_CHINESE_SIMPLIFIED)
MAKELANGID(LANG_CHINESE, SUBLANG_CHINESE_TRADITIONAL)
MAKELANGID(LANG_CZECH, SUBLANG_NEUTRAL)
MAKELANGID(LANG_DUTCH, SUBLANG_NEUTRAL)
MAKELANGID(LANG_ENGLISH, SUBLANG_NEUTRAL)
MAKELANGID(LANG_FRENCH, SUBLANG_NEUTRAL)
MAKELANGID(LANG_GERMAN, SUBLANG_NEUTRAL)
MAKELANGID(LANG_ITALIAN, SUBLANG_NEUTRAL)
MAKELANGID(LANG_JAPANESE, SUBLANG_NEUTRAL)
MAKELANGID(LANG_KOREAN, SUBLANG_NEUTRAL)
MAKELANGID(LANG_POLISH, SUBLANG_NEUTRAL)
MAKELANGID(LANG_PORTUGUESE, SUBLANG_NEUTRAL)
MAKELANGID(LANG_RUSSIAN, SUBLANG_NEUTRAL)
MAKELANGID(LANG_SPANISH, SUBLANG_NEUTRAL)
MAKELANGID(LANG_SWEDISH, SUBLANG_NEUTRAL)

Return Values

If the function succeeds, and cchEULA is nonzero, the return value is the number of EULA characters (Unicode or ANSI) written to the buffer pointed to by lpszEULA. If the function succeeds, and cchEULA is zero, the return value is the required size, in ANSI or Unicode characters, for a buffer that can receive the EULA string.

If the function fails, the return value is zero. To get extended error information, call etLastError.

Remarks

The compiler setting also determines the function version. If Unicode is defined, the function call resolves to DirectXSetupGetEULAW. Otherwise, the function call resolves to DirectXSetupGetEULAA because ANSI strings are being used.

If a LangID is passed that is not supported, the function will fail and return 0. In this case, the etLastError return value will be ERROR_INVALID_PARAMETER. ERROR_INVALID_PARAMETER is also returned for the following reasons.

The setup application must display the EULA with in accordance with the DirectX SDK EULA.

The EULA must be displayed and accepted before continuing with DirectSetup.

Requirements

Header: Declared in Dsetup.h.