Funzione DrvGetDirectDrawInfo (winddi.h)

Articolo
03/13/2024

La funzione DrvGetDirectDrawInfo restituisce le funzionalità dell'hardware grafico.

Sintassi

BOOL DrvGetDirectDrawInfo(
  DHPDEV      dhpdev,
  DD_HALINFO  *pHalInfo,
  DWORD       *pdwNumHeaps,
  VIDEOMEMORY *pvmList,
  DWORD       *pdwNumFourCCCodes,
  DWORD       *pdwFourCC
);

Parametri

dhpdev

Handle al PDEV restituito dalla routine DrvEnablePDEV del driver.

pHalInfo

Punta a una struttura DD_HALINFO in cui il driver deve restituire le funzionalità hardware supportate.

pdwNumHeaps

Punta alla posizione in cui il driver deve restituire il numero di strutture VIDEOMEMORY puntate da pvmList.

pvmList

Punta a una matrice di strutture VIDEOMEMORY in cui il driver deve restituire informazioni su ogni blocco di memoria visualizzato che controlla. Il driver deve ignorare questo parametro quando è NULL.

pdwNumFourCCCodes

Punta alla posizione in cui il driver deve restituire il numero di DWORD puntati da pdwFourCC.

pdwFourCC

Punta a una matrice di DWORD in cui il driver deve restituire informazioni su ogni FOURCC supportato. Il driver deve ignorare questo parametro quando è NULL.

Valore restituito

DrvGetDirectDrawInfo restituisce TRUE se ha esito positivo; in caso contrario, restituisce FALSE.

Commenti

La routine DrvGetDirectDrawInfo del driver deve eseguire le operazioni seguenti:

Quando pvmList e pdwFourCC sono NULL:
1. Riservare memoria di visualizzazione offscreen per l'uso di DirectDraw.
2. Scrivere rispettivamente il numero di heaps di memoria di visualizzazione del driver e QUATTROCC supportati in pdwNumHeaps e pdwNumFourCC.
Quando pvmList e pdwFourCC non sono NULL:
1. Scrivere rispettivamente il numero di heaps di memoria di visualizzazione del driver e QUATTROCC supportati in pdwNumHeaps e pdwNumFourCC.
2. Per ogni struttura VIDEOMEMORY nell'elenco a cui punta pvmList compilare i membri appropriati per descrivere un determinato blocco di memoria visualizzato. L'elenco delle strutture fornisce DirectDraw con una descrizione completa della memoria offscreen del driver.
Inizializzare i membri della struttura DD_HALINFO con informazioni specifiche del driver come indicato di seguito:
1. Inizializzare i membri appropriati della struttura VIDEOMEMORYINFO in vmiData per descrivere le caratteristiche generali della memoria dello schermo.
2. Inizializzare i membri appropriati della struttura DDCORECAPS in ddCaps per descrivere le funzionalità dell'hardware.
3. Se il driver implementa una funzione DdGetDriverInfo , impostare GetDriverInfo su di esso e impostare dwFlags su DDHALINFO_GETDRIVERINFOSET.