DXGKDDI_MIRACAST_CREATE_CONTEXT Rückruffunktion (dispmprt.h)
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 zu einem Kontextblock, der einem Anzeigeadapter zugeordnet ist. Die DxgkDdiAddDevice-Funktion des Display-Miniporttreibers stellt dieses Handle zuvor für das DirectX-Grafik-Kernel-Subsystem bereit.
[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 für diese Miracast-Geräteinstanz 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 eine der Fehlercodes zurückgegeben, die in Ntstatus.h definiert sind, einschließlich:
| Rückgabecode | Beschreibung |
|---|---|
| STATUS_RESOURCE_IN_USE | Die zur Unterstützung einer verbundenen Miracast-Sitzung erforderlichen Hardwareressourcen sind derzeit nicht verfügbar. |
Bemerkungen
Wenn diese Funktion aufgerufen wird, sollte der Anzeigeminiporttreiber alle Kernelmodusressourcen vorbereiten, die für die Unterstützung einer verbundenen Miracast-Sitzung erforderlich sind.
Synchronisierung
Das Betriebssystem gruppiert die DxgkDdiMiracastCreateContext, DxgkDdiMiracastDestroyContextund DxgkDdiMiracastIoControl als Miracast Klasse. Das Betriebssystem garantiert, dass diese Funktionen den Synchronisierungsmodus der zweiten Ebene befolgen, wie in Threading und Synchronisierung second Leveldefiniert. 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. Allerdings kann jeweils nur eine dieser Miracast-Klassenfunktionen der Ebene 2 aufgerufen werden.Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows 8.1 |
| mindestens unterstützte Server- | Windows Server 2012 R2 |
| Zielplattform- | Desktop |
| Header- | dispmprt.h (include Dispmprt.h) |
| IRQL- | PASSIVE_LEVEL |