DD_GETDRIVERINFODATA struttura (ddrawint.h)
La struttura DD_GETDRIVERINFODATA viene usata per passare i dati a e dalla routine di callback DdGetDriverInfo .
Sintassi
typedef struct _DD_GETDRIVERINFODATA {
VOID *dhpdev;
DWORD dwSize;
DWORD dwFlags;
GUID guidInfo;
DWORD dwExpectedSize;
PVOID lpvData;
DWORD dwActualSize;
HRESULT ddRVal;
} *PDD_GETDRIVERINFODATA, DD_GETDRIVERINFODATA;
Members
dhpdev
Gestire il file PDEV del driver. Solo Microsoft Windows 2000 e versioni successive.
dwSize
Specifica le dimensioni in byte di questa struttura DD_GETDRIVERINFODATA.
dwFlags
Attualmente inutilizzato ed è impostato su zero.
guidInfo
Specifica il GUID del supporto microsoft DirectX per cui viene eseguito la query del driver. In un driver Windows 2000 e versioni successive di Microsoft DirectDraw questo membro può essere uno dei valori seguenti (in ordine alfabetico):
| GUID | Descrizione |
|---|---|
| GUID_ColorControlCallbacks | Esegue una query sul fatto che il driver supporti DdControlColor. Se il driver lo supporta, il driver deve inizializzare e restituire una struttura DD_COLORCONTROLCALLBACKS nel buffer a cui punta lpvData . |
| GUID_D3DCallbacks | Esegue una query sul fatto che il driver supporti una delle funzionalità specificate tramite la struttura D3DHAL_CALLBACKS . Se il driver non fornisce alcun supporto, deve inizializzare e restituire una struttura D3DHAL_CALLBACKS nel buffer a cui punta lpvData . |
| GUID_D3DCallbacks2 | Obsoleta. |
| GUID_D3DCallbacks3 | Esegue una query sul fatto che il driver supporti una delle funzionalità specificate tramite la struttura D3DHAL_CALLBACKS3 . Se il driver fornisce uno qualsiasi di questo supporto, deve inizializzare e restituire una struttura D3DHAL_CALLBACKS3 nel buffer a cui punta lpvData . |
| GUID_D3DCaps | Obsoleta. |
| GUID_D3DExtendedCaps | Esegue query sul fatto che il driver supporti una delle funzionalità di Microsoft Direct3D specificate tramite la struttura D3DHAL_D3DEXTENDEDCAPS . Se il driver fornisce uno qualsiasi di questo supporto, deve inizializzare e restituire una struttura D3DHAL_D3DEXTENDEDCAPS nel buffer a cui punta lpvData . |
| GUID_D3DParseUnknownCommandCallback | Fornisce la parte Direct3D del driver con il runtime Direct3D D3dParseUnknownCommandCallback. Il callback D3dDrawPrimitives2 del driver chiama D3dParseUnknownCommandCallback per analizzare i comandi dal buffer dei comandi non compreso dal driver. DirectDraw passa un puntatore a questa funzione nel buffer a cui punta lpvData . Se il driver supporta questo aspetto di Direct3D, deve archiviare il puntatore. |
| GUID_GetHeapAlignment | Esegue una query sul fatto che il driver supporti i requisiti di allineamento della superficie su base heap. Se il driver fornisce questo supporto, deve inizializzare e restituire una struttura DD_GETHEAPALIGNMENTDATA nel buffer a cui punta lpvData . |
| GUID_KernelCallbacks | Esegue una query sul fatto che il driver supporti una delle funzionalità specificate tramite la struttura DD_KERNELCALLBACKS . Se il driver fornisce uno qualsiasi di questo supporto, deve inizializzare e restituire una struttura DD_KERNELCALLBACKS nel buffer a cui punta lpvData . |
| GUID_KernelCaps | Esegue query su se il driver supporta una delle funzionalità in modalità kernel specificate tramite la struttura DDKERNELCAPS . Se il driver fornisce uno di questo supporto, deve inizializzare e restituire una struttura DDKERNELCAPS nel buffer a cui punta lpvData . |
| GUID_MiscellaneousCallbacks | Esegue query sul fatto che il driver supporti DdGetAvailDriverMemory. Se il driver lo supporta, il driver deve inizializzare e restituire una struttura DD_MISCELLANEOUSCALLBACKS nel buffer a cui punta lpvData . |
| GUID_Miscellaneous2Callbacks | Esegue query sul fatto che il driver supporti le funzionalità aggiuntive specificate nella struttura DD_MISCELLANEOUS2CALLBACKS . Se il driver supporta uno qualsiasi di questo supporto, il driver deve inizializzare e restituire una struttura DD_MISCELLANEOUS2CALLBACKS nel buffer a cui punta lpvData . |
| GUID_MotionCompCallbacks | Esegue una query sul fatto che il driver supporti la funzionalità di compensazione del movimento specificata tramite la struttura DD_MOTIONCOMPCALLBACKS . Se il driver fornisce uno di questo supporto, deve inizializzare e restituire una struttura DD_MOTIONCOMPCALLBACKS nel buffer a cui punta lpvData . |
| GUID_NonLocalVidMemCaps | Esegue query sul fatto che il driver supporti una delle funzionalità di memoria di visualizzazione non locali specificate tramite la struttura DD_NONLOCALVIDMEMCAPS . Se il driver fornisce uno qualsiasi di questo supporto, deve inizializzare e restituire una struttura DD_NONLOCALVIDMEMCAPS nel buffer a cui punta lpvData . |
| GUID_NTCallbacks | Esegue query sul fatto che il driver supporti una delle funzionalità specificate tramite la struttura DD_NTCALLBACKS . Se il driver fornisce uno di questo supporto, deve inizializzare e restituire una struttura DD_NTCALLBACKS nel buffer a cui punta lpvData . |
| GUID_NTPrivateDriverCaps | Esegue una query sul fatto che il driver supporti le tecniche di creazione della superficie di windows 98/Me specificate tramite la struttura DD_NTPRIVATEDRIVERCAPS . Se il driver fornisce uno di questo supporto, deve inizializzare e restituire una struttura DD_NTPRIVATEDRIVERCAPS nel buffer a cui punta lpvData . |
| GUID_UpdateNonLocalHeap | Esegue una query sul fatto che il driver supporti il recupero degli indirizzi di base di ogni heap non locale. Se il driver fornisce questo supporto, deve inizializzare e restituire una struttura DD_UPDATENONLOCALHEAPDATA nel buffer a cui punta lpvData . |
| GUID_VideoPortCallbacks | Esegue una query sul fatto che il driver supporti le estensioni della porta video (VPE). Se il driver supporta VPE, deve inizializzare e restituire una struttura DD_VIDEOPORTCALLBACKS nel buffer a cui punta lpvData . |
| GUID_VideoPortCaps | Esegue query se il driver supporta una delle funzionalità dell'oggetto VPE specificate tramite la struttura DDVIDEOPORTCAPS . Se il driver fornisce uno di questo supporto, deve inizializzare e restituire una struttura DDVIDEOPORTCAPS nel buffer a cui punta lpvData . |
| GUID_ZPixelFormats | Esegue una query sui formati pixel supportati dal buffer di profondità. Se il driver supporta Direct3D, deve allocare e inizializzare i membri appropriati di una struttura DDPIXELFORMAT per ogni formato di buffer z supportato e restituirli nel buffer a cui punta lpvData . |
dwExpectedSize
Specifica il numero di byte di dati che DirectDraw prevede il passaggio del driver nel buffer a cui punta lpvData .
lpvData
Punta a un buffer allocato DirectDraw in cui il driver copia i dati richiesti. Questo buffer è in genere dwExpectedSize di dimensioni. Il driver non deve scrivere più di dwExpectedSize byte di dati. Il driver specifica il numero di byte che scrive nel buffer nel membro dwActualSize .
dwActualSize
Specifica il percorso in cui il driver restituisce il numero di byte di dati scritti in lpvData.
ddRVal
Specifica il percorso in cui il driver scrive il valore restituito del callback DdGetDriverInfo . Un codice restituito di DD_OK indica l'esito positivo. Per altre informazioni, vedere Restituire valori per DirectDraw.
Commenti
La struttura dei dati passata al driver per una chiamata DdGetDriverInfo presenta differenze minori tra Windows 98/Me e Windows 2000 e versioni successive. In Windows 2000 e versioni successive la struttura dei dati viene chiamata DD_GETDRIVERINFODATA e in Windows 98/Me la struttura dei dati viene chiamata DDHAL_GETDRIVERINFODATA. Entrambe le strutture di dati includono un campo per informazioni di contesto specifiche del driver. In Windows 2000 e versioni successive, DD_GETDRIVERINFODATA include un campo dhpdev che archivia il DHPDEV del driver chiamato. Solo in Windows 98/Me, DDHAL_GETDRIVERINFODATA include un campo dwContext copiato per il campo dwReserved3 riservato driver dell'oggetto globale DirectDraw.
Requisiti
| Requisito | Valore |
|---|---|
| Intestazione | ddrawint.h (include Winddi.h) |