Развернуть Свернуть

DxgkDdiCreateOverlay routine

The DxgkDdiCreateOverlay function enables the overlay hardware if the hardware is capable.

Syntax


PDXGKDDI_CREATEOVERLAY DxgkDdiCreateOverlay;

NTSTATUS APIENTRY DxgkDdiCreateOverlay(
  _In_     const HANDLE hAdapter,
  _Inout_  DXGKARG_CREATEOVERLAY *pCreateOverlay
)
{ ... }

Parameters

hAdapter [in]

[in] A handle to a context block that is associated with a display adapter. The display miniport driver previously provided this handle to the Microsoft DirectX graphics kernel subsystem in the MiniportDeviceContext output parameter of the DxgkDdiAddDevice function.

pCreateOverlay [in, out]

[in/out] A pointer to a DXGKARG_CREATEOVERLAY structure that describes the overlay.

Return value

DxgkDdiCreateOverlay returns one of the following values:

Return codeDescription
STATUS_SUCCESS

DxgkDdiCreateOverlay successfully created the overlay.

STATUS_INVALID_PARAMETER

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

STATUS_NO_MEMORY

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

STATUS_INSUFFICIENT_RESOURCES

DxgkDdiCreateOverlay 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 DxgkDdiCreateOverlay.

 

Remarks

DxgkDdiCreateOverlay 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
DxgkDdiAddDevice

 

 

Send comments about this topic to Microsoft

Показ:
© 2014 Microsoft