PFN_HANDLE_KMD_MESSAGE Rückruffunktion (netdispumdddi.h)
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) |