PDD_MAPMEMORY funzione di callback (ddrawint.h)

Articolo
03/05/2024

La funzione di callback DdMapMemory esegue il mapping delle parti modificabili dell'applicazione del buffer frame nello spazio indirizzi in modalità utente del processo specificato o della memoria non mappata.

Sintassi

PDD_MAPMEMORY PddMapmemory;

DWORD PddMapmemory(
  PDD_MAPMEMORYDATA unnamedParam1
)
{...}

Parametri

unnamedParam1

Punta a una struttura DD_MAPMEMORYDATA che contiene i dettagli per il mapping della memoria o l'operazione di annullamento del mapping.

Valore restituito

DdMapMemory restituisce uno dei codici di callback seguenti:

Commenti

DdMapMemory viene chiamato per eseguire il mapping della memoria prima della prima chiamata a DdLock. L'handle restituito dal driver nel membro fpProcess della struttura di DD_MAPMEMORYDATA in lpMapMemory verrà passato a ogni chiamata DdLock effettuata sul driver.

DdMapMemory viene chiamato anche per annullare il mapping della memoria dopo l'ultima chiamata DdUnlock .

Per impedire l'arresto anomalo del driver, il driver non deve eseguire il mapping di alcuna parte del buffer del frame che non deve essere modificato da un'applicazione.

Il driver di visualizzazione deve chiamare sul driver miniport video per eseguire il mapping della memoria o annullare il mapping della memoria. Per inviare una richiesta sincrona al driver miniport video per eseguire il mapping della memoria, il driver di visualizzazione chiama la funzione GDI EngDeviceIoControl con IOCTL_VIDEO_SHARE_VIDEO_MEMORY o IOCTL_VIDEO_MAP_VIDEO_MEMORY. Il driver di visualizzazione invia IOCTL_VIDEO_UNSHARE_VIDEO_MEMORY o IOCTL_VIDEO_UNMAP_VIDEO_MEMORY al driver miniport video per annullare il mapping della memoria. Per altre informazioni, vedere Comunicazione di IOCTLs al driver Video Miniport.

DdMapMemory può essere chiamato solo con un PDEV disabilitato per annullare il mapping della memoria. Un PDEV è disabilitato o abilitato chiamando la funzione DrvAssertMode del driver visualizzato. Per altre informazioni, vedere Gestione di PDEV .