estructura DD_GETDRIVERINFODATA (ddrawint.h)
La estructura DD_GETDRIVERINFODATA se usa para pasar datos hacia y desde la rutina de devolución de llamada DdGetDriverInfo .
Sintaxis
typedef struct _DD_GETDRIVERINFODATA {
VOID *dhpdev;
DWORD dwSize;
DWORD dwFlags;
GUID guidInfo;
DWORD dwExpectedSize;
PVOID lpvData;
DWORD dwActualSize;
HRESULT ddRVal;
} *PDD_GETDRIVERINFODATA, DD_GETDRIVERINFODATA;
Miembros
dhpdev
Maneje el PDEV del controlador. Microsoft Windows 2000 y versiones posteriores solo.
dwSize
Especifica el tamaño en bytes de esta estructura de DD_GETDRIVERINFODATA.
dwFlags
Actualmente no se usa y se establece en cero.
guidInfo
Especifica el GUID de la compatibilidad de Microsoft DirectX con la que se está consultando el controlador. En un controlador de Windows 2000 y versiones posteriores de Microsoft DirectDraw, este miembro puede ser uno de los siguientes valores (en orden alfabético):
| GUID | Descripción |
|---|---|
| GUID_ColorControlCallbacks | Consulta si el controlador admite DdControlColor. Si el controlador lo admite, el controlador debe inicializar y devolver una estructura de DD_COLORCONTROLCALLBACKS en el búfer al que apunta lpvData . |
| GUID_D3DCallbacks | Consulta si el controlador admite cualquiera de las funciones especificadas a través de la estructura D3DHAL_CALLBACKS . Si el controlador no proporciona ninguna de esta compatibilidad, debe inicializar y devolver una estructura de D3DHAL_CALLBACKS en el búfer al que apunta lpvData . |
| GUID_D3DCallbacks2 | Obsoleto. |
| GUID_D3DCallbacks3 | Consulta si el controlador admite cualquiera de las funciones especificadas a través de la estructura D3DHAL_CALLBACKS3 . Si el controlador proporciona cualquiera de esta compatibilidad, debe inicializar y devolver una estructura de D3DHAL_CALLBACKS3 en el búfer al que apunta lpvData . |
| GUID_D3DCaps | Obsoleto. |
| GUID_D3DExtendedCaps | Consulta si el controlador admite cualquiera de las funciones de Microsoft Direct3D especificadas a través de la estructura D3DHAL_D3DEXTENDEDCAPS . Si el controlador proporciona cualquiera de esta compatibilidad, debe inicializar y devolver una estructura de D3DHAL_D3DEXTENDEDCAPS en el búfer al que apunta lpvData . |
| GUID_D3DParseUnknownCommandCallback | Proporciona la parte direct3D del controlador con el D3dParseUnknownCommandCallback del entorno de ejecución de Direct3D. La devolución de llamada D3dDrawPrimitives2 del controlador llama a D3dParseUnknownCommandCallback para analizar los comandos del búfer de comandos que el controlador no entiende. DirectDraw pasa un puntero a esta función en el búfer al que apunta lpvData . Si el controlador admite este aspecto de Direct3D, debe almacenar el puntero. |
| GUID_GetHeapAlignment | Consulta si el controlador admite los requisitos de alineación de superficie por montón. Si el controlador proporciona esta compatibilidad, debe inicializar y devolver una estructura de DD_GETHEAPALIGNMENTDATA en el búfer al que apunta lpvData . |
| GUID_KernelCallbacks | Consulta si el controlador admite cualquiera de las funciones especificadas a través de la estructura DD_KERNELCALLBACKS . Si el controlador proporciona cualquiera de esta compatibilidad, debe inicializar y devolver una estructura de DD_KERNELCALLBACKS en el búfer al que apunta lpvData . |
| GUID_KernelCaps | Consulta si el controlador admite cualquiera de las funcionalidades del modo kernel especificadas a través de la estructura DDKERNELCAPS . Si el controlador proporciona cualquiera de esta compatibilidad, debe inicializar y devolver una estructura DDKERNELCAPS en el búfer al que apunta lpvData . |
| GUID_MiscellaneousCallbacks | Consulta si el controlador admite DdGetAvailDriverMemory. Si el controlador lo admite, el controlador debe inicializar y devolver una estructura de DD_MISCELLANEOUSCALLBACKS en el búfer al que apunta lpvData . |
| GUID_Miscellaneous2Callbacks | Consulta si el controlador admite la funcionalidad adicional de varios especificado en la estructura DD_MISCELLANEOUS2CALLBACKS . Si el controlador admite cualquiera de esta compatibilidad, el controlador debe inicializar y devolver una estructura de DD_MISCELLANEOUS2CALLBACKS en el búfer al que apunta lpvData . |
| GUID_MotionCompCallbacks | Consulta si el controlador admite la funcionalidad de compensación de movimiento especificada a través de la estructura DD_MOTIONCOMPCALLBACKS . Si el controlador proporciona cualquiera de esta compatibilidad, debe inicializar y devolver una estructura de DD_MOTIONCOMPCALLBACKS en el búfer al que apunta lpvData . |
| GUID_NonLocalVidMemCaps | Consulta si el controlador admite cualquiera de las funcionalidades de memoria de visualización no local especificadas a través de la estructura de DD_NONLOCALVIDMEMCAPS . Si el controlador proporciona cualquiera de esta compatibilidad, debe inicializar y devolver una estructura de DD_NONLOCALVIDMEMCAPS en el búfer al que apunta lpvData . |
| GUID_NTCallbacks | Consulta si el controlador admite cualquiera de las funciones especificadas a través de la estructura DD_NTCALLBACKS . Si el controlador proporciona cualquiera de esta compatibilidad, debe inicializar y devolver una estructura de DD_NTCALLBACKS en el búfer al que apunta lpvData . |
| GUID_NTPrivateDriverCaps | Consulta si el controlador admite las técnicas de creación de superficies de estilo Windows 98/Me especificadas a través de la estructura DD_NTPRIVATEDRIVERCAPS . Si el controlador proporciona cualquiera de esta compatibilidad, debe inicializar y devolver una estructura de DD_NTPRIVATEDRIVERCAPS en el búfer al que apunta lpvData . |
| GUID_UpdateNonLocalHeap | Consulta si el controlador admite la recuperación de las direcciones base de cada montón no local a su vez. Si el controlador proporciona esta compatibilidad, debe inicializar y devolver una estructura de DD_UPDATENONLOCALHEAPDATA en el búfer al que apunta lpvData . |
| GUID_VideoPortCallbacks | Consulta si el controlador admite las extensiones de puerto de vídeo (VPE). Si el controlador admite VPE, debe inicializar y devolver una estructura de DD_VIDEOPORTCALLBACKS en el búfer al que apunta lpvData . |
| GUID_VideoPortCaps | Consulta si el controlador admite cualquiera de las funcionalidades del objeto VPE especificadas a través de la estructura DDVIDEOPORTCAPS . Si el controlador proporciona cualquiera de esta compatibilidad, debe inicializar y devolver una estructura DDVIDEOPORTCAPS en el búfer al que apunta lpvData . |
| GUID_ZPixelFormats | Consulta los formatos de píxeles admitidos por el búfer de profundidad. Si el controlador admite Direct3D, debe asignar e inicializar los miembros adecuados de una estructura DDPIXELFORMAT para cada formato de búfer z que admita y devolverlos en el búfer al que apunta lpvData . |
dwExpectedSize
Especifica el número de bytes de datos que DirectDraw espera que el controlador devuelva en el búfer al que apunta lpvData .
lpvData
Apunta a un búfer asignado a DirectDraw en el que el controlador copia los datos solicitados. Este búfer suele ser dwExpectedSize bytes de tamaño. El controlador no debe escribir más de dwExpectedSize bytes de datos en él. El controlador especifica el número de bytes que escribe en este búfer en el miembro dwActualSize .
dwActualSize
Especifica la ubicación en la que el controlador devuelve el número de bytes de datos que escribe en lpvData.
ddRVal
Especifica la ubicación en la que el controlador escribe el valor devuelto de la devolución de llamada DdGetDriverInfo . Un código de retorno de DD_OK indica que se ha realizado correctamente. Para obtener más información, vea Valores devueltos para DirectDraw.
Comentarios
La estructura de datos que se pasa al controlador para una llamada DdGetDriverInfo tiene pequeñas diferencias entre Windows 98/Me y Windows 2000 y versiones posteriores. En Windows 2000 y versiones posteriores, la estructura de datos se denomina DD_GETDRIVERINFODATA y en Windows 98/Me, la estructura de datos se denomina DDHAL_GETDRIVERINFODATA. Ambas estructuras de datos incluyen un campo para información de contexto específica del controlador. En Windows 2000 y versiones posteriores, DD_GETDRIVERINFODATA incluye un campo dhpdev que almacena el DHPDEV del controlador al que se llama. Solo en Windows 98/Me, DDHAL_GETDRIVERINFODATA incluye un campo dwContext que se copia para el campo dwReserved3 reservado del controlador del objeto global DirectDraw.
Requisitos
| Requisito | Valor |
|---|---|
| Header | ddrawint.h (incluya Winddi.h) |