PFN_HANDLE_KMD_MESSAGE Rückruffunktion (netdispumdddi.h)

Artikel
03/01/2024

Wird vom Betriebssystem aufgerufen, um die asynchrone Kernelmodusmeldung zu verarbeiten, die der Miracast-Benutzermodustreiber empfängt, wenn der Anzeige-Miniporttreiber 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 einer Grafikkarte zugeordnet ist.

Das Betriebssystem hat den Kontext abgerufen, wenn es die CreateMiracastContext-Funktion des Miracast-Benutzermodustreibers aufgerufen hat.

[in] InputBufferSize

Die Größe des vom Betriebssystem bereitgestellten Eingabepuffers pInputBuffer.

[in] pInputBuffer

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

[in] OutputBufferSize

Die Größe des vom Betriebssystem bereitgestellten Ausgabepuffers pOutputBuffer.

[out] pOutputBuffer

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

[out] pBytesReturned

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

Rückgabewert

Bei Erfolg gibt diese Funktion STATUS_SUCCESS zurück. Andernfalls gibt die Funktion einen im Ntstatus.h-Header definierten Fehlercode zurück.

Hinweise

Threadsicherheit

Wenn diese Funktion aufgerufen wird, ist es möglich, dass sie auch in einem anderen Thread aufgerufen wurde. Der Treiber ist daher dafür verantwortlich, bei Bedarf mehrere Aufrufe von HandleKernelModeMessage zu synchronisieren.

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

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 8.1
Unterstützte Mindestversion (Server)	Windows Server 2012 R2
Zielplattform	Desktop
Kopfzeile	netdispumdddi.h (include Netdispumdddi.h)