LPDDENUMCALLBACKEXW callback function (ddraw.h)
The DDEnumCallbackEx function is an application-defined callback function for the DirectDrawEnumerateEx function.
Syntax
LPDDENUMCALLBACKEXW Lpddenumcallbackexw;
BOOL Lpddenumcallbackexw(
GUID *unnamedParam1,
LPWSTR unnamedParam2,
LPWSTR unnamedParam3,
LPVOID unnamedParam4,
HMONITOR unnamedParam5
)
{...}
Parameters
unnamedParam1
A pointer to the unique identifier of the DirectDraw object.
unnamedParam2
Address of a string that contains the driver name.
unnamedParam3
Address of a string that contains the driver description.
unnamedParam4
A pointer to an application-defined structure to be passed to the callback function each time that the function is called.
unnamedParam5
Handle of the monitor that is associated with the enumerated DirectDraw object. This parameter is NULL when the enumerated DirectDraw object is for the primary device, a nondisplay device (such as a 3-D accelerator with no 2-D capabilities), or devices not attached to the desktop.
Return value
The callback function returns nonzero to continue the enumeration.
It returns zero to stop the enumeration.
Remarks
After the DirectDrawEnumerateEx function completes, the pointer to the GUID at lpGUID is no longer valid. You must save a copy of the GUID structure itself, not the pointer, or the DirectDrawCreateEx function fails.
You can use the LPDDENUMCALLBACKEX data type to declare a variable that can contain a pointer to this callback function.
If UNICODE is defined, the string values are returned as type LPWSTR, rather than LPSTR.
Note
The ddraw.h header defines LPDDENUMCALLBACKEX as an alias which automatically selects the ANSI or Unicode version of this function based on the definition of the UNICODE preprocessor constant. Mixing usage of the encoding-neutral alias with code that not encoding-neutral can lead to mismatches that result in compilation or runtime errors. For more information, see Conventions for Function Prototypes.
Requirements
Requirement | Value |
---|---|
Target Platform | Windows |
Header | ddraw.h |
Feedback
https://aka.ms/ContentUserFeedback.
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see:Submit and view feedback for