DXGKDDI_MIRACAST_DESTROY_CONTEXT callback function (dispmprt.h)

Article
02/22/2024

Destroys an instance of a Miracast device.

Syntax

DXGKDDI_MIRACAST_DESTROY_CONTEXT DxgkddiMiracastDestroyContext;

void DxgkddiMiracastDestroyContext(
  [in] PVOID DriverContext,
  [in] PVOID MiracastContext
)
{...}

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] MiracastContext

The Miracast device context, supplied by the operating system. This context was previously provided by the driver in a call to the DxgkDdiMiracastCreateContext function.

Return value

None

Remarks

When this function is called, the display miniport driver should release all kernel-mode resources that it allocated when it processed the DxgkDdiMiracastCreateContext function, and it should immediately send a monitor departure hot-plug detection (HPD) awareness value to the operating system.

The operating system guarantees that, after it calls this function, it will not make any more calls to the DxgkDdiMiracastIoControl function.

If a Miracast device is disconnected before the DxgkDdiCommitVidPn function completes, while a present operation is still occurring on this Miracast target, the display miniport driver should not send any data to the user-mode Miracast driver.

If the user-mode StopMiracastSession function takes too long to complete, the operating system calls DxgkDdiMiracastDestroyContext while the user-mode Miracast driver is still running. In this case, the operating system blocks any further calls to the user-mode MiracastIoControl function.

Synchronization

The operating system groups the DxgkDdiMiracastCreateContext, DxgkDdiMiracastDestroyContext, and DxgkDdiMiracastIoControl functions as a Miracast class. The operating system guarantees that these functions follow the second-level synchronization mode as defined in Threading and Synchronization Second Level. These functions can be called when other level 0, 1, or other classes of level 2 functions are being called on another thread context. However, only one of these level 2 Miracast-class functions can be called at a time.

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