PFN_CREATE_MIRACAST_CONTEXT callback function (netdispumdddi.h)

Article
02/22/2024

Called by the operating system to create a user-mode Miracast context.

Syntax

PFN_CREATE_MIRACAST_CONTEXT PfnCreateMiracastContext;

NTSTATUS PfnCreateMiracastContext(
  [in]  HANDLE hMiracastDeviceHandle,
  [in]  MIRACAST_CALLBACKS *pMiracastCallbacks,
  [out] PVOID *ppMiracastContext
)
{...}

Parameters

[in] hMiracastDeviceHandle

A handle to the current Miracast display device, supplied by the operating system.

[in] pMiracastCallbacks

A pointer to a MIRACAST_CALLBACKS structure that has pointers to callback functions, supplied by the operating system, that the Miracast user-mode driver can call.

[out] ppMiracastContext

A pointer to a buffer, supplied by the operating system, that holds the Miracast context that the Miracast user-mode driver returns.

Return value

On success, this function returns STATUS_SUCCESS. Otherwise, the function returns an error code defined in the Ntstatus.h header.

Remarks

When this function is called, the Miracast user-mode driver should prepare all resources that it needs for a new Miracast connected session.

The driver can call the callback functions pointed to by pMiracastCallbacks only during the lifetime of the current Miracast context.

Thread Safety

The operating system guarantees that only one of the CreateMiracastContext, DestroyMiracastContext, StartMiracastSession, and StopMiracastSession functions is called at a time.

Requirements

Requirement	Value
Minimum supported client	Windows 8.1
Minimum supported server	Windows Server 2012 R2
Target Platform	Desktop
Header	netdispumdddi.h (include Netdispumdddi.h)