DXGKDDI_MIRACAST_HANDLE_IO_CONTROL Rückruffunktion (dispmprt.h)

Artikel
02/23/2024

Wird vom Betriebssystem aufgerufen, um anzufordern, dass der Anzeigeminiporttreiber eine synchrone E/A-Steuerungsanforderung als Reaktion auf einen Aufruf des Benutzermodusanzeigetreibers an die MiracastIoControl-Funktion verarbeitet.

Syntax

DXGKDDI_MIRACAST_HANDLE_IO_CONTROL DxgkddiMiracastHandleIoControl;

NTSTATUS DxgkddiMiracastHandleIoControl(
  [in]  PVOID DriverContext,
  [in]  PVOID MiracastContext,
  [in]  ULONG InputBufferSize,
  [in]  VOID *pInputBuffer,
  [in]  ULONG OutputBufferSize,
  [out] VOID *pOutputBuffer,
  [out] ULONG *BytesReturned
)
{...}

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

Der Vom Betriebssystem bereitgestellte Miracast-Gerätekontext. Dieser Kontext wurde vom Anzeigeminiporttreiber in einem Aufruf der DxgkDdiMiracastCreateContext-Funktion bereitgestellt.

[in] InputBufferSize

Wird vom Betriebssystem als Größe des Eingabepuffers in Bytes angegeben, auf die pInputBuffer verweist. Dieser Wert entstand als InputBufferSize-Parameter der MiracastIoControl-Funktion des Benutzermodus.

[in] pInputBuffer

Wird vom Betriebssystem als Zeiger auf den Eingabepuffer bereitgestellt. Dieser Wert entstand als InputBufferSize-Parameter der MiracastIoControl-Funktion des Benutzermodus.

InputBufferSize gibt die Größe des Puffers an.

[in] OutputBufferSize

Wird vom Betriebssystem als Größe des Ausgabepuffers in Bytes angegeben, auf die pOutputBuffer verweist.

Dieser Wert entstand als OutputBufferSize-Parameter der MiracastIoControl-Funktion im Benutzermodus.

[out] pOutputBuffer

Wird vom Betriebssystem als Zeiger auf den Ausgabepuffer bereitgestellt. Dieser Wert entstand als pOutputBuffer-Parameter der MiracastIoControl-Funktion im Benutzermodus.

OutBufferSize gibt die Größe des Puffers an.

[out] BytesReturned

Wird vom Betriebssystem als Zeiger auf einen Puffer bereitgestellt, der einen Wert vom Typ ULONG enthält, der die Anzahl von Bytes darstellt, die der Anzeigeminiporttreiber im Puffer zurückgegeben hat, auf den pOutputBuffer verweist.

Rückgabewert

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

Hinweise

Das Betriebssystem garantiert, dass ein Aufruf von DxgkDdiMiracastIoControl im selben Prozessbereich erfolgt, in dem die MiracastIoControl-Anforderung im Benutzermodus aufgerufen wird.

Obwohl das Betriebssystem lediglich die Werte der Eingabe- und Ausgabepuffergrößen aus den jeweiligen Parametern von MiracastIoControl kopiert, ist der Anzeigeminiporttreiber für die Überprüfung der Puffergrößen vor der Verwendung der Puffer zuständig. Außerdem sollte der Treiber Mithilfe der Funktionen ProbeForRead und/oder ProbeForWrite innerhalb eines try/except-Aufrufblocks untersuchen, um den Arbeitsspeicher im Benutzermodus zu überprüfen, auf den Eingabepuffer verweisen.

Dieser E/A-Steuerungsvorgang wird synchron mit einem Aufruf der MiracastIoControl-Funktion im Benutzermodus verarbeitet.

Synchronisierung

Das Betriebssystem gruppiert die Funktionen DxgkDdiMiracastCreateContext, DxgkDdiMiracastDestroyContext und DxgkDdiMiracastIoControl als Miracast-Klasse .

Die Threading- und Synchronisierungsebene für diese Funktion wird festgelegt, indem der Benutzermodustreiber den HardwareAccess-Parameter in einem Aufruf der MiracastIoControl-Funktion festlegt:

Wenn HardwareAccessFALSE ist, garantiert das Betriebssystem, dass DxgkDdiMiracastIoControl dem Synchronisierungsmodus der zweiten Ebene folgt, wie in Threading und Synchronisierung zweiter Ebene definiert. DxgkDdiMiracastIoControl kann aufgerufen werden, wenn andere Klassen der Ebene 0, 1 oder Nicht-Miracast-Klassen von Funktionen der Ebene 2 in einem anderen Threadkontext aufgerufen werden. Es kann jedoch nur eine der Miracast-Klassenfunktionen der Ebene 2 gleichzeitig aufgerufen werden.
Wenn HardwareAccessTRUE ist, folgt DxgkDdiMiracastIoControl dem Synchronisierungsmodus der dritten Ebene, der in Threading und Synchronisierung dritter Ebene definiert ist. Beachten Sie, dass das Leeren der GPU zu einem erheblichen Verarbeitungsaufwand führt.

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