Funzione DdCreateDirectDrawObject (ddrawgdi.h)

[Questa funzione è soggetta a modifiche con ogni revisione del sistema operativo. Usare invece DirectDraw e Microsoft Direct3DAPIs; queste API isolano le applicazioni da tali modifiche al sistema operativo e nascondono molte altre difficoltà nell'interagire direttamente con i driver di visualizzazione.

Wrapper per la funzione NtGdiDdCreateDirectDrawObject e crea una rappresentazione lato kernel dell'oggetto Microsoft DirectDraw. Un handle per questa rappresentazione verrà archiviato in pDirectDrawGlobal-hDD>.

GdiEntry1 è definito come alias per questa funzione.

Sintassi

BOOL DdCreateDirectDrawObject(
  LPDDRAWI_DIRECTDRAW_GBL pDirectDrawGlobal,
  HDC                     hdc
);

Parametri

pDirectDrawGlobal

Puntatore all'oggetto DirectDraw in modalità utente. Per informazioni dettagliate, vedere la documentazione di DDK.

hdc

Gestire il controller di dominio per il dispositivo per il quale viene creata questa rappresentazione. Se 0, il dispositivo sarà il dispositivo "display". Si noti che questa funzione mantiene un solo oggetto DirectDraw "display" e restituirà un handle copiato allo stesso oggetto se successivamente chiamato con hdc = 0.

Valore restituito

In caso di esito positivo, questa funzione restituisce TRUE; in caso contrario restituisce FALSE.

Commenti

Le applicazioni sono consigliate di usare le API DirectDraw e Direct3D per creare e gestire oggetti dispositivo grafico. Questi costrutti astraggono il processo di creazione del dispositivo in modo semplificato e indipendente dal sistema operativo.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	ddrawgdi.h

Vedi anche

Supporto client grafica di basso livello