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)

Vedi anche

DdGetDriverInfo