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