PFN_HANDLE_KMD_MESSAGE Rückruffunktion (netdispumdddi.h)

Wird vom Betriebssystem aufgerufen, um die asynchrone Kernelmodusnachricht zu behandeln, die der Miracast-Benutzermodustreiber empfängt, wenn der Anzeige miniport-Treiber die DxgkCbMiracastSendMessage-Funktion aufruft.

Syntax

PFN_HANDLE_KMD_MESSAGE PfnHandleKmdMessage;

NTSTATUS PfnHandleKmdMessage(
  [in]  PVOID pMiracastContext,
  [in]  UINT InputBufferSize,
  [in]  VOID *pInputBuffer,
  [in]  UINT OutputBufferSize,
  [out] VOID *pOutputBuffer,
  [out] UINT *pBytesReturned
)
{...}

Parameter

[in] pMiracastContext

Ein Zeiger auf einen Kontext, der einem Anzeigeadapter zugeordnet ist.

Das Betriebssystem hat den Kontext abgerufen, wenn er die Funktion "CreateMiracastContext " des Miracast-Benutzermodus-Treibers aufgerufen hat.

[in] InputBufferSize

Die Größe des Eingabepuffers pInputBuffer, der vom Betriebssystem bereitgestellt wird.

[in] pInputBuffer

Ein Zeiger auf den Eingabepuffer, der vom Betriebssystem bereitgestellt wird.

[in] OutputBufferSize

Die Größe des Ausgabepuffers pOutputBuffer, der vom Betriebssystem bereitgestellt wird.

[out] pOutputBuffer

Ein Zeiger auf den Ausgabepuffer, der vom Betriebssystem bereitgestellt wird.

[out] pBytesReturned

Ein Zeiger auf einen Puffer, der vom Betriebssystem bereitgestellt wird, enthält die Anzahl der zurückgegebenen Bytes, die der Anzeige-Miniporttreiber in pOutputBuffer geschrieben hat.

Rückgabewert

Bei Erfolg gibt diese Funktion STATUS_SUCCESS zurück. Andernfalls gibt die Funktion einen Fehlercode zurück, der im Ntstatus.h-Header definiert ist.

Bemerkungen

Threadsicherheit

Wenn diese Funktion aufgerufen wird, ist es möglich, dass sie auch in einem anderen Thread aufgerufen wurde. Der Treiber ist daher für die Synchronisierung mehrerer Anrufe mit HandleKernelModeMessage verantwortlich, falls erforderlich.

Das Betriebssystem garantiert, dass diese Funktion nicht aufgerufen wird, wenn CreateMiracastContext, DestroyMiracastContext, StartMiracastSession und StopMiracastSession aufgerufen werden. Alle Nachrichten, die der Anzeige-Miniporttreiber während des Starts einer miracast verbundenen Sitzung (StartMiracastSession) sendet, werden blockiert, bis der Sitzungsstartvorgang abgeschlossen ist. Das Betriebssystem blockiert auch alle Nachrichten, die der Display-Miniporttreiber während oder nach einem Anruf sendet, um die Miracast-Sitzung zu beenden (StopMiracastSession).

Requirements (Anforderungen)

   
Unterstützte Mindestversion (Client) Windows 8.1
Unterstützte Mindestversion (Server) Windows Server 2012 R2
Zielplattform Desktop
Header netdispumdddi.h (einschließlich Netdispumdddi.h)

Weitere Informationen

CreateMiracastContext

DestroyMiracastContext

DxgkCbMiracastSendMessage

StartMiracastSession

StopMiracastSession