DXGKDDI_MIRACAST_QUERY_CAPS callback function (dispmprt.h)

Article
10/21/2021

Queries the Miracast capabilities of the current display adapter. The operating system calls this function only when the display adapter is first started and then stores the capabilities that are returned.

Note The capabilities of the display adapter must not change while it is connected.

Syntax

DXGKDDI_MIRACAST_QUERY_CAPS DxgkddiMiracastQueryCaps;

NTSTATUS DxgkddiMiracastQueryCaps(
  [in]  PVOID DriverContext,
  [in]  ULONG MiracastCapsSize,
  [out] DXGK_MIRACAST_CAPS *MiracastCaps
)
{...}

Parameters

[in] DriverContext

A handle to a context block that is associated with a display adapter. The display miniport driver's DxgkDdiAddDevice function previously provided this handle to the DirectX graphics kernel subsystem.

[in] MiracastCapsSize

The size, supplied by the operating system, of the DXGK_MIRACAST_CAPS structure pointed to by the MiracastCaps parameter.

The driver should check this value before it fills the structure.

[out] MiracastCaps

A pointer to an operating system-provided buffer that holds a DXGK_MIRACAST_CAPS structure that the driver fills with Miracast device capabilities.

Return value

Returns STATUS_SUCCESS if it succeeds. Otherwise, it returns one of the error codes that are defined in Ntstatus.h.

Remarks

Synchronization

The operating system guarantees that this function follows the third-level synchronization mode as defined in Threading and Synchronization Third Level.

Requirements

Requirement	Value
Minimum supported client	Windows 8.1
Minimum supported server	Windows Server 2012 R2
Target Platform	Desktop
Header	dispmprt.h (include Dispmprt.h)
IRQL	PASSIVE_LEVEL