DXGKDDI_MIRACAST_CREATE_CONTEXT funzione di callback (dispmprt.h)

Articolo
02/23/2024

Crea un contesto in modalità kernel per un dispositivo Miracast.

Sintassi

DXGKDDI_MIRACAST_CREATE_CONTEXT DxgkddiMiracastCreateContext;

NTSTATUS DxgkddiMiracastCreateContext(
  [in]  PVOID DriverContext,
  [in]  DXGK_MIRACAST_DISPLAY_CALLBACKS *MiracastCallbacks,
  [out] PVOID *MiracastContext,
  [out] ULONG *TargetId
)
{...}

Parametri

[in] DriverContext

Handle a un blocco di contesto associato a una scheda di visualizzazione. La funzione DxgkDdiAddDevice del driver di visualizzazione ha fornito in precedenza questo handle al sottosistema del kernel della grafica DirectX.

[in] MiracastCallbacks

Puntatore a un buffer fornito dal sistema operativo che contiene una struttura DXGK_MIRACAST_DISPLAY_CALLBACKS con puntatori alle funzioni di callback che il driver può chiamare.

[out] MiracastContext

Puntatore a un buffer fornito dal sistema operativo che contiene l'indirizzo del contesto allocato dal driver per questa istanza del dispositivo Miracast.

[out] TargetId

Puntatore a un buffer fornito dal sistema operativo che contiene l'ID della destinazione VidPN a cui è connesso il dispositivo Miracast. Il driver deve segnalare questa destinazione come tipo D3DKMDT_VOT_MIRACAST quando il sistema operativo chiama la funzione DxgkDdiQueryChildRelations durante l'inizializzazione del dispositivo.

Valore restituito

Restituisce STATUS_SUCCESS se ha esito positivo. In caso contrario, restituisce uno dei codici di errore definiti in Ntstatus.h, tra cui:

Codice restituito	Descrizione
STATUS_RESOURCE_IN_USE	Le risorse hardware necessarie per supportare una sessione connessa Miracast non sono attualmente disponibili.

Commenti

Quando questa funzione viene chiamata, il driver miniport visualizzato deve preparare tutte le risorse in modalità kernel che deve supportare una sessione connessa Miracast.

Sincronizzazione

Il sistema operativo raggruppa le funzioni DxgkDdiMiracastCreateContext, DxgkDdiMiracastDestroyContext e DxgkDdiMiracastIoControl come classe Miracast . Il sistema operativo garantisce che queste funzioni seguono la modalità di sincronizzazione di secondo livello, come definito in Threading e Sync Second Level. Queste funzioni possono essere chiamate quando viene chiamato un altro livello 0, 1 o altre classi di funzioni di livello 2 in un altro contesto di thread. Tuttavia, solo una di queste funzioni di classe Miracast di livello 2 può essere chiamata alla volta.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 8.1
Server minimo supportato	Windows Server 2012 R2
Piattaforma di destinazione	Desktop
Intestazione	dispmprt.h (include Dispmprt.h)
IRQL	PASSIVE_LEVEL

Vedi anche

DXGK_MIRACAST_DISPLAY_CALLBACKS

DxgkDdiAddDevice

DxgkDdiQueryChildRelations

Condividi tramite