PFN_HANDLE_KMD_MESSAGE funzione di callback (netdispumdddi.h)

Articolo
08/07/2023

Chiamato dal sistema operativo per gestire il messaggio in modalità kernel asincrona che il driver in modalità utente Miracast riceve quando il driver miniport visualizzato chiama la funzione DxgkCbMiracastSendMessage .

Sintassi

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
)
{...}

Parametri

[in] pMiracastContext

Puntatore a un contesto associato a una scheda di visualizzazione.

Il sistema operativo ha ottenuto il contesto quando ha chiamato la funzione CreateMiracastContext del driver in modalità utente Miracast.

[in] InputBufferSize

Dimensioni del buffer di input pInputBuffer, fornite dal sistema operativo.

[in] pInputBuffer

Puntatore al buffer di input fornito dal sistema operativo.

[in] OutputBufferSize

Dimensioni del buffer di output pOutputBuffer, fornite dal sistema operativo.

[out] pOutputBuffer

Puntatore al buffer di output, fornito dal sistema operativo.

[out] pBytesReturned

Puntatore a un buffer, fornito dal sistema operativo, che contiene il numero di byte restituiti che il driver miniport visualizzato ha scritto in pOutputBuffer.

Valore restituito

In caso di esito positivo, questa funzione restituisce STATUS_SUCCESS. In caso contrario, la funzione restituisce un codice di errore definito nell'intestazione Ntstatus.h.

Commenti

Thread safety

Quando questa funzione viene chiamata, è possibile che sia stata chiamata anche in un altro thread. Il driver è quindi responsabile della sincronizzazione di più chiamate a HandleKernelModeMessage , se necessario.

Il sistema operativo garantisce che questa funzione non venga chiamata quando viene chiamata CreateMiracastContext, DestroyMiracastContext, StartMiracastSession e StopMiracastSession. Tutti i messaggi inviati dal driver miniport visualizzato durante l'avvio di una sessione connessa Miracast (StartMiracastSession) vengono bloccati fino al completamento del processo di avvio della sessione. Il sistema operativo blocca anche tutti i messaggi inviati dal driver miniport visualizzato durante o dopo una chiamata per arrestare la sessione Miracast (StopMiracastSession).

Requisiti

Requisito	Valore
Client minimo supportato	Windows 8.1
Server minimo supportato	Windows Server 2012 R2
Piattaforma di destinazione	Desktop
Intestazione	netdispumdddi.h (include Netdispumdddi.h)