D3DDDIARG_OPENADAPTER struttura (d3dumddi.h)

  • Articolo

La struttura D3DDDIARG_OPENADAPTER contiene informazioni che descrivono l'oggetto scheda grafica.

Sintassi

typedef struct _D3DDDIARG_OPENADAPTER {
  [in/out] HANDLE                        hAdapter;
  [in]     UINT                          Interface;
  [in]     UINT                          Version;
  [in]     const D3DDDI_ADAPTERCALLBACKS *pAdapterCallbacks;
  [out]    D3DDDI_ADAPTERFUNCS           *pAdapterFuncs;
  [out]    UINT                          DriverVersion;
} D3DDDIARG_OPENADAPTER;

Members

[in/out] hAdapter

Handle per l'oggetto scheda grafica. In input della funzione OpenAdapter, hAdapter specifica l'handle che il driver deve usare per eseguire query sulle funzionalità della scheda grafica quando il driver chiama la funzione di callback pfnQueryAdapterInfoCb fornita dal driver Microsoft Direct3D.

Il driver genera un handle univoco e lo passa al runtime Direct3D. Nell'output della funzione OpenAdapter hAdapter specifica l'handle usato dal runtime Direct3D nelle chiamate driver successive per identificare l'oggetto scheda grafica.

[in] Interface

Versione dell'interfaccia Direct3D/DirectDraw (ad esempio, 7, 8 o 9) che apre la scheda grafica.

[in] Version

Numero che il driver può usare per identificare quando è stato compilato il runtime Direct3D/DirectDraw. Ad esempio, il driver può usare il numero di versione per distinguere un runtime rilasciato con Windows Vista e un runtime rilasciato con un Service Pack successivo, che potrebbe contenere una correzione necessaria per il driver.

[in] pAdapterCallbacks

Puntatore a una struttura di D3DDDI_ADAPTERCALLBACKS contenente la funzione di callback pfnQueryAdapterInfoCb fornita dal runtime Direct3D.

[out] pAdapterFuncs

Puntatore a una struttura D3DDDI_ADAPTERFUNCS che contiene una tabella di funzioni specifiche del driver di visualizzazione in modalità utente. Il runtime Direct3D usa queste funzioni per comunicare con il driver di visualizzazione in modalità utente sulle operazioni specifiche della scheda grafica.

[out] DriverVersion

Versione dell'interfaccia del driver di visualizzazione in modalità utente Direct3D, ottenuta dal file di intestazione D3dumddi.h , con cui è stato compilato il driver. Il driver di visualizzazione in modalità utente deve restituire D3D_UMD_INTERFACE_VERSION.

Nota Se un driver in modalità utente non supporta le funzionalità di Windows 7 (DXGKDDI_INTERFACE_VERSION < DXGKDDI_INTERFACE_VERSION_WIN7) e si vuole compilare il driver con Windows 7 WDK (versione 7600), assicurarsi che il driver restituisca D3D_UMD_INTERFACE_VERSION_VISTA.
 

Requisiti

Requisito Valore
Client minimo supportato Disponibile in Windows Vista e versioni successive dei sistemi operativi Windows.
Intestazione d3dumddi.h (include D3dumddi.h)

Vedi anche

D3DDDI_ADAPTERCALLBACKS

D3DDDI_ADAPTERFUNCS

OpenAdapter

pfnQueryAdapterInfoCb