Expand Minimize

DxgkDdiUpdateOverlay routine

The DxgkDdiUpdateOverlay function modifies the overlay hardware.

Syntax


PDXGKDDI_UPDATEOVERLAY DxgkDdiUpdateOverlay;

NTSTATUS APIENTRY DxgkDdiUpdateOverlay(
  _In_  const HANDLE hOverlay,
  _In_  const DXGKARG_UPDATEOVERLAY *pUpdateOverlay
)
{ ... }

Parameters

hOverlay [in]

[in] A handle to the overlay to modify. The display miniport driver's DxgkDdiCreateOverlay function previously provided this handle to the Microsoft DirectX graphics kernel subsystem in the hOverlay member of the DXGKARG_CREATEOVERLAY structure that pCreateOverlay points to.

pUpdateOverlay [in]

[in] A pointer to a DXGKARG_UPDATEOVERLAY structure that describes how to modify the overlay hardware.

Return value

DxgkDdiUpdateOverlay returns one of the following values:

Return codeDescription
STATUS_SUCCESS

DxgkDdiUpdateOverlay successfully modified the overlay.

STATUS_INVALID_PARAMETER

Parameters that were passed to DxgkDdiUpdateOverlay contained errors that prevented it from completing.

STATUS_NO_MEMORY

DxgkDdiUpdateOverlay could not allocate memory that was required for it to complete.

STATUS_INSUFFICIENT_RESOURCES

DxgkDdiUpdateOverlay could not complete because insufficient bandwidth was available or the requested overlay hardware could not complete the task.

STATUS_GRAPHICS_DRIVER_MISMATCH

The display miniport driver is not compatible with the user-mode display driver that initiated the call to DxgkDdiUpdateOverlay.

 

Remarks

DxgkDdiUpdateOverlay should be made pageable.

Requirements

Version

Available in Windows Vista and later versions of the Windows operating systems.

Header

D3dkmddi.h (include D3dkmddi.h)

IRQL

PASSIVE_LEVEL

See also

DXGKARG_CREATEOVERLAY
DXGKARG_UPDATEOVERLAY
DxgkDdiCreateOverlay

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft