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)

Consulte también

DdGetDriverInfo