[This function is subject to change with each operating system revision. Instead, use the DirectDraw and Microsoft Direct3DAPIs; these APIs insulate applications from such operating system changes, and hide many other difficulties involved in interacting directly with display drivers.]
Re-enables a Microsoft DirectDraw kernel-mode device object after a mode switch.
Syntax
BOOL APIENTRY NtGdiDdReenableDirectDrawObject(
_In_ HANDLE hDirectDrawLocal,
_Inout_ BOOL *pubNewMode
);
Parameters
hDirectDrawLocal [in]
DirectDraw object that needs to be re-enabled.
pubNewMode [in, out]
Pointer to a BOOL that will be filled with a value that represents whether the display mode changed.
Return value
If successful (the device can be re-enabled), this function returns TRUE. Otherwise (for example, the display driver was changed), it returns FALSE.
Remarks
Once the object has been re-enabled, the capabilities for the device can be re-queried via a call to NtGdiDdQueryDirectDrawObject.
Applications are advised to use the DirectDraw or Direct3D version 8 APIs, which automate and abstract this process in a manner independent of the operating system.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows 2000 Professional [desktop apps only] |
| Minimum supported server | Windows 2000 Server [desktop apps only] |
| Header | Ntgdi.h |
See also
Graphics Low Level Client Support
Source: Microsoft Learn / Windows Win32 documentation by Microsoft and contributors. Documentation licensed CC BY 4.0. Code samples are covered by the MIT License. Converted from Markdown, with links normalized and embedded media omitted.
