NtGdiDdReenableDirectDrawObject function

Article
01/06/2021

[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