Funzione NtGdiD3DDrawPrimitives2

  • Articolo

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

Esegue il rendering delle primitive e restituisce lo stato di rendering aggiornato.

Sintassi

DWORD APIENTRY NtGdiD3DDrawPrimitives2(
  _In_    HANDLE                         hCmdBuf,
  _In_    HANDLE                         hVBuf,
  _Inout_ LPD3DNTHAL_DRAWPRIMITIVES2DATA pded,
  _Inout_ FLATPTR                        *pfpVidMemCmd,
  _Inout_ DWORD                          *pdwSizeCmd,
  _Inout_ FLATPTR                        *pfpVidMemVtx,
  _Inout_ DWORD                          *pdwSizeVtx
);

Parametri

hCmdBuf [in]

Gestire la struttura DD_SURFACE_LOCAL che identifica la superficie DirectDraw contenente i dati del comando.

hVBuf [in]

Gestire la struttura DD_SURFACE_LOCAL che identifica la superficie DirectDraw contenente i dati del vertice.

pded [in, out]

Puntatore a una struttura D3DNTHAL_DRAWPRIMITIVES2DATA contenente le informazioni necessarie per il driver per eseguire il rendering di una o più primitive.

pfpVidMemCmd [in, out]

Nuovo puntatore alla memoria video se il driver ha scambiato il buffer dei comandi.

pdwSizeCmd [in, out]

Specifica il numero minimo di byte per cui il driver deve aumentare il buffer dei comandi di scambio.

pfpVidMemVtx [in, out]

Nuovo puntatore alla memoria video se il driver ha scambiato il buffer del vertice.

pdwSizeVtx [in, out]

Specifica il numero minimo di byte che il driver deve allocare per il buffer dei vertici di scambio.

Valore restituito

NtGdiD3DDrawPrimitives2 restituisce uno dei codici di callback seguenti.

Codice restituito Descrizione
DDHAL_DRIVER_HANDLED
 Il driver ha eseguito l'operazione e ha restituito un codice restituito valido per tale operazione. Se questo codice è DD_OK, DirectDraw o Direct3D procede con la funzione. In caso contrario, DirectDraw o Direct3D restituisce il codice di errore fornito dal driver e interrompe la funzione.
DDHAL_DRIVER_NOTHANDLED
 Il driver non ha alcun commento sull'operazione richiesta. Se è necessario che il driver abbia implementato un callback specifico, DirectDraw o Direct3D segnala una condizione di errore. In caso contrario, DirectDraw o Direct3D gestisce l'operazione come se il callback del driver non fosse stato definito eseguendo l'implementazione indipendente dal dispositivo DirectDraw o Direct3D.

 

Requisiti

Requisito Valore
Client minimo supportato
 Windows 2000 Professional [solo app desktop]
Server minimo supportato
 Windows 2000 Server [solo app desktop]
Intestazione
Ntgdi.h

Vedi anche

Supporto client a basso livello di grafica