DXGKDDI_MIRACAST_CREATE_CONTEXT Rückruffunktion (dispmprt.h)

  • Artikel

Erstellt einen Kernelmoduskontext für ein Miracast-Gerät.

Syntax

DXGKDDI_MIRACAST_CREATE_CONTEXT DxgkddiMiracastCreateContext;

NTSTATUS DxgkddiMiracastCreateContext(
  [in]  PVOID DriverContext,
  [in]  DXGK_MIRACAST_DISPLAY_CALLBACKS *MiracastCallbacks,
  [out] PVOID *MiracastContext,
  [out] ULONG *TargetId
)
{...}

Parameter

[in] DriverContext

Ein Handle für einen Kontextblock, der einem Anzeigeadapter zugeordnet ist. Die DxgkDdiAddDevice-Funktion des Anzeigeminiporttreibers hat dieses Handle zuvor für das DirectX-Grafikkernsubsystem bereitgestellt.

[in] MiracastCallbacks

Ein Zeiger auf einen vom Betriebssystem bereitgestellten Puffer, der eine DXGK_MIRACAST_DISPLAY_CALLBACKS-Struktur enthält, die Zeiger auf Rückruffunktionen enthält, die der Treiber aufrufen kann.

[out] MiracastContext

Ein Zeiger auf einen vom Betriebssystem bereitgestellten Puffer, der die Adresse des Kontexts enthält, den der Treiber diesem Miracast-Gerät instance zugewiesen hat.

[out] TargetId

Ein Zeiger auf einen vom Betriebssystem bereitgestellten Puffer, der die ID des VidPN-Ziels enthält, mit dem das Miracast-Gerät verbunden ist. Der Treiber sollte dieses Ziel als Typ D3DKMDT_VOT_MIRACAST melden, wenn das Betriebssystem die DxgkDdiQueryChildRelations-Funktion während der Geräteinitialisierung aufruft.

Rückgabewert

Gibt STATUS_SUCCESS zurück, wenn dies erfolgreich ist. Andernfalls wird einer der Fehlercodes zurückgegeben, die in "Ntstatus.h" definiert sind, einschließlich:

Rückgabecode Beschreibung
STATUS_RESOURCE_IN_USE Die Hardwareressourcen, die für die Unterstützung einer verbundenen Miracast-Sitzung erforderlich sind, sind derzeit nicht verfügbar.

Hinweise

Wenn diese Funktion aufgerufen wird, sollte der Anzeigeminiporttreiber alle Kernelmodusressourcen vorbereiten, die er benötigt, um eine verbundene Miracast-Sitzung zu unterstützen.

Synchronisierung

Das Betriebssystem gruppiert die Funktionen DxgkDdiMiracastCreateContext, DxgkDdiMiracastDestroyContext und DxgkDdiMiracastIoControl als Miracast-Klasse . Das Betriebssystem garantiert, dass diese Funktionen dem Synchronisierungsmodus der zweiten Ebene folgen, wie in Threading und Synchronisierung zweiter Ebene definiert. Diese Funktionen können aufgerufen werden, wenn andere Klassen der Ebene 0, 1 oder andere Klassen von Funktionen der Ebene 2 in einem anderen Threadkontext aufgerufen werden. Es kann jedoch nur eine dieser Miracast-Klassenfunktionen der Ebene 2 gleichzeitig aufgerufen werden.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 8.1
Unterstützte Mindestversion (Server) Windows Server 2012 R2
Zielplattform Desktop
Kopfzeile dispmprt.h (include Dispmprt.h)
IRQL PASSIVE_LEVEL

Weitere Informationen

DXGK_MIRACAST_DISPLAY_CALLBACKS

DxgkDdiAddDevice

DxgkDdiQueryChildRelations