Estructura DDCORECAPS (ddrawi.h)
La estructura DDCORECAPS especifica las funciones principales del controlador de Microsoft DirectDraw y su dispositivo, que se exponen a una aplicación a través del objeto DirectDraw.
Sintaxis
typedef struct _DDCORECAPS {
DWORD dwSize;
DWORD dwCaps;
DWORD dwCaps2;
DWORD dwCKeyCaps;
DWORD dwFXCaps;
DWORD dwFXAlphaCaps;
DWORD dwPalCaps;
DWORD dwSVCaps;
DWORD dwAlphaBltConstBitDepths;
DWORD dwAlphaBltPixelBitDepths;
DWORD dwAlphaBltSurfaceBitDepths;
DWORD dwAlphaOverlayConstBitDepths;
DWORD dwAlphaOverlayPixelBitDepths;
DWORD dwAlphaOverlaySurfaceBitDepths;
DWORD dwZBufferBitDepths;
DWORD dwVidMemTotal;
DWORD dwVidMemFree;
DWORD dwMaxVisibleOverlays;
DWORD dwCurrVisibleOverlays;
DWORD dwNumFourCCCodes;
DWORD dwAlignBoundarySrc;
DWORD dwAlignSizeSrc;
DWORD dwAlignBoundaryDest;
DWORD dwAlignSizeDest;
DWORD dwAlignStrideAlign;
DWORD dwRops[DD_ROP_SPACE];
DDSCAPS ddsCaps;
DWORD dwMinOverlayStretch;
DWORD dwMaxOverlayStretch;
DWORD dwMinLiveVideoStretch;
DWORD dwMaxLiveVideoStretch;
DWORD dwMinHwCodecStretch;
DWORD dwMaxHwCodecStretch;
DWORD dwReserved1;
DWORD dwReserved2;
DWORD dwReserved3;
DWORD dwSVBCaps;
DWORD dwSVBCKeyCaps;
DWORD dwSVBFXCaps;
DWORD dwSVBRops[DD_ROP_SPACE];
DWORD dwVSBCaps;
DWORD dwVSBCKeyCaps;
DWORD dwVSBFXCaps;
DWORD dwVSBRops[DD_ROP_SPACE];
DWORD dwSSBCaps;
DWORD dwSSBCKeyCaps;
DWORD dwSSBFXCaps;
DWORD dwSSBRops[DD_ROP_SPACE];
DWORD dwMaxVideoPorts;
DWORD dwCurrVideoPorts;
DWORD dwSVBCaps2;
} DDCORECAPS;
Miembros
dwSize
Especifica el tamaño en bytes de esta estructura DDCORECAPS.
dwCaps
Indica una marca que especifica las funcionalidades del controlador. El controlador debe establecer el bit DDCAPS_Xxx adecuado para cada funcionalidad que admita.
| Marca | Significado |
|---|---|
| DDCAPS_3D | El hardware de pantalla tiene aceleración 3D. |
| DDCAPS_ALIGNBOUNDARYDEST | DirectDraw solo admite esos rectángulos de origen con el eje x alineado con los límites dwAlignBoundaryDest de la superficie. |
| DDCAPS_ALIGNBOUNDARYSRC | DirectDraw solo admite esos rectángulos de origen con el eje x alineado con los límites dwAlignBoundarySrc de la superficie. |
| DDCAPS_ALIGNSIZEDEST | DirectDraw solo admite los rectángulos de origen cuyos tamaños de eje x, en bytes, son múltiplos dwAlignSizeDest . |
| DDCAPS_ALIGNSIZESRC | DirectDraw solo admite los rectángulos de origen cuyos tamaños de eje X, en bytes, son múltiplos dwAlignSizeSrc . |
| DDCAPS_ALIGNSTRIDE | DirectDraw crea superficies de memoria para mostrar que tienen una alineación de paso igual al valor dwAlignStrideAlign . |
| DDCAPS_ALPHA | El hardware de pantalla admite un canal alfa durante las operaciones de blit. |
| DDCAPS_BANKSWITCHED | El hardware de pantalla se cambia mediante banco y es potencialmente muy lento en el acceso aleatorio a la memoria de visualización. Si el controlador de Microsoft Windows 2000 o posterior establece este bit de funcionalidad, DirectDraw está deshabilitado. |
| DDCAPS_BLT | El hardware de pantalla es capaz de realizar operaciones en bloque. |
| DDCAPS_BLTCOLORFILL | El hardware de pantalla es capaz de rellenar el color con un blitter. |
| DDCAPS_BLTDEPTHFILL | El hardware de pantalla es capaz de rellenar z-buffers de profundidad con un blitter. |
| DDCAPS_BLTFOURCC | El hardware de pantalla es capaz de realizar conversiones de espacio de color durante las operaciones de blit. |
| DDCAPS_BLTQUEUE | El hardware de pantalla es capaz de operaciones de bits asincrónicas. |
| DDCAPS_BLTSTRETCH | El hardware de pantalla es capaz de estirarse durante las operaciones de blit. |
| DDCAPS_CANBLTSYSMEM | El hardware de pantalla es capaz de transferir a memoria del sistema o desde él. |
| DDCAPS_CANCLIP | El hardware de pantalla es capaz de recortar con recortes. |
| DDCAPS_CANCLIPSTRETCHED | El hardware de pantalla es capaz de recortar mientras se recortan los tramos. |
| DDCAPS_COLORKEY | Se admite algún tipo de clave de color en las operaciones de superposición o de bits. Puede encontrar información de funcionalidad de clave de color más específica en el miembro dwCKeyCaps . |
| DDCAPS_COLORKEYHWASSIST | La clave de color es asistida por hardware. |
| DDCAPS_GDI | El hardware de visualización se comparte con GDI. Si el controlador de Windows 2000 o posterior establece este bit de funcionalidad, DirectDraw está deshabilitado. |
| DDCAPS_NOHARDWARE | No existe compatibilidad con hardware. |
| DDCAPS_OVERLAY | El hardware de pantalla admite superposiciones. |
| DDCAPS_OVERLAYCANTCLIP | El hardware de pantalla admite superposiciones, pero no puede recortarlas. |
| DDCAPS_OVERLAYFOURCC | El hardware de superposición es capaz de realizar conversiones de espacio de color durante las operaciones de superposición. |
| DDCAPS_OVERLAYSTRETCH | El hardware de superposición es capaz de estirarse. |
| DDCAPS_PALETTE | DirectDraw es capaz de crear y admitir objetos DirectDrawPalette para algo más que solo la superficie principal. Si el controlador de Windows 2000 o posterior establece este bit de funcionalidad, DirectDraw está deshabilitado. |
| DDCAPS_PALETTEVSYNC | DirectDraw es capaz de actualizar una paleta sincronizada con la actualización vertical. |
| DDCAPS_READSCANLINE | El hardware de pantalla es capaz de devolver la línea de examen actual. |
| DDCAPS_STEREOVIEW | El hardware de pantalla tiene capacidades de visión estéreo. |
| DDCAPS_VBI | El hardware de pantalla es capaz de generar una interrupción vertical en blanco. |
| DDCAPS_ZBLTS | Admite el uso de búferes z con operaciones blit. |
| DDCAPS_ZOVERLAYS | Admite el uso del método UpdateOverlayZOrder de la aplicación como valor z para que las superposiciones controlen sus capas. Si el controlador de Windows 2000 o posterior establece este bit de funcionalidad, DirectDraw está deshabilitado. |
dwCaps2
Especifique más de las funcionalidades del controlador. El controlador debe establecer el bit DDCAPS2_Xxx adecuado para cada funcionalidad que admita.
| Marca | Significado |
|---|---|
| DDCAPS2_AUTOFLIPOVERLAY | La superposición se puede voltear automáticamente a la siguiente superficie de la cadena de volteo cada vez que se produce una sincronización V del puerto de vídeo de hardware, lo que permite que el objeto de extensiones de puerto de vídeo (VPE) y la superposición a doble búfer del vídeo sin sobrecarga de CPU. Esta opción solo es válida cuando la superficie recibe datos del puerto de vídeo de hardware. Si los datos del puerto de vídeo de hardware no están entrelazados o no intercalados, se voltea en cada sincronización de V. Si los datos se intercalan en la memoria, se voltea en todas las demás sincronizaciones de V. |
| DDCAPS2_CANAUTOGENMIPMAP |
|
| DDCAPS2_CANBOBHARDWARE | El hardware de superposición puede mostrar cada campo de una secuencia de vídeo entrelazada individualmente. |
| DDCAPS2_CANBOBINTERLEAVED | El hardware de superposición puede mostrar cada campo de una secuencia de vídeo entrelazada individualmente mientras se intercala en memoria sin causar artefactos que normalmente se produzcan sin soporte de hardware especial. Esta opción solo es válida cuando la superficie recibe datos de un objeto VPE y solo es válida cuando el vídeo se acerca al menos al 200 por ciento en la dirección vertical. |
| DDCAPS2_CANBOBNONINTERLEAVED | El hardware de superposición puede mostrar cada campo de una secuencia de vídeo entrelazada individualmente mientras no está intercalado en la memoria sin causar artefactos que normalmente se produzcan sin soporte de hardware especial. Esta opción solo es válida cuando la superficie recibe datos de un objeto VPE y solo es válida cuando el vídeo se acerca al menos al 200 por ciento en la dirección vertical. |
| DDCAPS2_CANCALIBRATEGAMMA | Un calibrador está disponible para ajustar la rampa gamma según las propiedades de visualización física para que el resultado sea idéntico en todos los sistemas calibrados. |
| DDCAPS2_CANDROPZ16BIT | Los valores RGBZ de dieciséis bits se pueden convertir en valores RGB de 16 bits. (El sistema no admite conversiones de ocho bits). |
| DDCAPS2_CANFLIPODDEVEN | El controlador admite bob mediante software sin usar un objeto VPE. |
| DDCAPS2_CANMANAGERESOURCE | El controlador admite la administración de recursos. |
| DDCAPS2_CANMANAGETEXTURE | El controlador admite la administración de texturas. |
| DDCAPS2_CANRENDERWINDOWED | El controlador puede representarse en modo de ventana. |
| DDCAPS2_CERTIFIED | El hardware de pantalla está certificado. |
| DDCAPS2_COLORCONTROLOVERLAY | La superficie de superposición contiene controles de color (brillo, nitidez, etc.). |
| DDCAPS2_COLORCONTROLPRIMARY | La superficie principal contiene controles de color (gamma, etc.). |
| DDCAPS2_COPYFOURCC | El controlador admite la migración de cualquier superficie FOURCC a otra superficie del mismo FOURCC. |
| DDCAPS2_FLIPINTERVAL | El controlador responde a las marcas de DDFLIP_INTERVAL2, DDFLIP_INTERVAL3 y DDFLIP_INTERVAL4. |
| DDCAPS2_FLIPNOVSYNC | El controlador responde a DDFLIP_FLIPNOVSYNC. |
| DDCAPS2_NO2DDURING3DSCENE | El controlador no puede intercalar operaciones 2D como DdBlt o DdLock en ninguna superficie que Microsoft Direct3D use entre llamadas a los métodos IDirect3DDevice::BeginScene e IDirect3DDevice::EndScene . |
| DDCAPS2_NONLOCALVIDMEM | El controlador admite memoria de visualización no local. |
| DDCAPS2_NONLOCALVIDMEMCAPS | Las funcionalidades de Blit para superficies de memoria de visualización no locales difieren de las superficies de memoria de visualización locales. Si esta marca está presente, también está presente la marca DDCAPS2_NONLOCALVIDMEM. |
| DDCAPS2_NOPAGELOCKREQUIRED | Se debe llamar al controlador para las ranuras que implican superficies de memoria del sistema, incluso si las superficies de memoria del sistema no están interbloqueadas. |
| DDCAPS2_PRIMARYGAMMA | El controlador admite rampas gamma cargables para la superficie principal. |
| DDCAPS2_VIDEOPORT | El hardware de visualización contiene un puerto de vídeo de hardware. |
| DDCAPS2_WIDESURFACES | El controlador de pantalla puede crear superficies más anchas que la superficie principal. Los controladores que establecen este bit deben esperar recibir solicitudes CreateSurface de las aplicaciones para superficies más anchas que la superficie principal. |
dwCKeyCaps
Especifique las funcionalidades de clave de color de las superficies. El controlador debe establecer el bit DDCKEYCAPS_Xxx adecuado para cada funcionalidad que admita.
| Marca | Significado |
|---|---|
| DDCKEYCAPS_DESTBLT | Admite la bifurcción transparente con una clave de color que identifica los bits reemplazables de la superficie de destino para los colores RGB. |
| DDCKEYCAPS_DESTBLTCLRSPACE | Admite la bifurcción transparente con un espacio de colores que identifica los bits reemplazables de la superficie de destino para los colores RGB. |
| DDCKEYCAPS_DESTBLTCLRSPACEYUV | Admite la bifurcción transparente con un espacio de colores que identifica los bits reemplazables de la superficie de destino para los colores YUV. |
| DDCKEYCAPS_DESTBLTYUV | Admite la bifurcción transparente con una clave de color que identifica los bits reemplazables de la superficie de destino para los colores YUV. |
| DDCKEYCAPS_DESTOVERLAY | Admite la superposición con las teclas de color de los bits reemplazables de la superficie de destino que se superponen para los colores RGB. |
| DDCKEYCAPS_DESTOVERLAYCLRSPACE | Admite un espacio de colores como clave de color para el destino de los colores RGB. |
| DDCKEYCAPS_DESTOVERLAYCLRSPACEYUV | Admite un espacio de colores como clave de color para el destino de los colores YUV. |
| DDCKEYCAPS_DESTOVERLAYONEACTIVE | Solo admite un valor de clave de color de destino activo para superficies de superposición visibles. |
| DDCKEYCAPS_DESTOVERLAYYUV | Admite la superposición mediante el uso de teclas de color de los bits reemplazables de la superficie de destino que se superponen para los colores YUV. |
| DDCKEYCAPS_NOCOSTOVERLAY | Indica que no hay inconvenientes de ancho de banda para usar la clave de color con una superposición. |
| DDCKEYCAPS_SRCBLT | Admite el corte transparente mediante la tecla de color para el origen con esta superficie para colores RGB. |
| DDCKEYCAPS_SRCBLTCLRSPACE | Admite la división transparente mediante un espacio de colores para el origen con esta superficie para colores RGB. |
| DDCKEYCAPS_SRCBLTCLRSPACEYUV | Admite la división transparente mediante un espacio de colores para el origen con esta superficie para los colores YUV. |
| DDCKEYCAPS_SRCBLTYUV | Admite la división transparente mediante la tecla de color para el origen con esta superficie para los colores YUV. |
| DDCKEYCAPS_SRCOVERLAY | Admite la superposición mediante la clave de color para el origen con esta superficie de superposición para colores RGB. |
| DDCKEYCAPS_SRCOVERLAYCLRSPACE | Admite la superposición mediante un espacio de colores como clave de color de origen para la superficie de superposición para los colores RGB. |
| DDCKEYCAPS_SRCOVERLAYCLRSPACEYUV | Admite la superposición mediante un espacio de colores como clave de color de origen para la superficie de superposición para los colores YUV. |
| DDCKEYCAPS_SRCOVERLAYONEACTIVE | Solo admite un valor de clave de color de origen activo para superficies de superposición visibles. |
| DDCKEYCAPS_SRCOVERLAYYUV | Admite la superposición mediante la clave de color para el origen con esta superficie de superposición para colores YUV. |
dwFXCaps
Especifique las capacidades de extensión y efectos del controlador. El controlador debe establecer el bit DDFXCAPS_Xxx adecuado para cada funcionalidad que admita.
| Marca | Significado |
|---|---|
| DDFXCAPS_BLTARITHSTRETCHY | Usa operaciones aritméticas, en lugar de técnicas de duplicación de píxeles, para estirar y reducir superficies durante una operación delit. Se produce a lo largo del eje Y (verticalmente). |
| DDFXCAPS_BLTARITHSTRETCHYN | Usa operaciones aritméticas, en lugar de técnicas de duplicación de píxeles, para estirar y reducir superficies durante una operación delit. Se produce a lo largo del eje Y (verticalmente) y solo funciona para el ajuste entero (x1, x2, etc.). |
| DDFXCAPS_BLTMIRRORLEFTRIGHT | Admite la creación de reflejo de izquierda a derecha en una operación delit. |
| DDFXCAPS_BLTMIRRORUPDOWN | Admite la creación de reflejo de arriba a abajo en una operación delit. |
| DDFXCAPS_BLTROTATION | Admite la rotación arbitraria en una operación blit. Si el controlador de Windows 2000 o posterior establece este bit de funcionalidad, DirectDraw está deshabilitado. |
| DDFXCAPS_BLTROTATION90 | Admite rotaciones de 90 grados en una operación delit. Si el controlador de Windows 2000 o posterior establece este bit de funcionalidad, DirectDraw está deshabilitado. |
| DDFXCAPS_BLTSHRINKX | Admite la reducción arbitraria de una superficie a lo largo del eje X (horizontalmente). Esta marca solo es válida para las operaciones de blit. |
| DDFXCAPS_BLTSHRINKXN | Admite la reducción de enteros (x1, x2, etc.) de una superficie a lo largo del eje X (horizontalmente). Esta marca solo es válida para las operaciones de blit. |
| DDFXCAPS_BLTSHRINKY | Admite la reducción arbitraria de una superficie a lo largo del eje Y (verticalmente). Esta marca solo es válida para las operaciones de blit. |
| DDFXCAPS_BLTSHRINKYN | Admite la reducción de enteros (x1, x2, etc.) de una superficie a lo largo del eje Y (verticalmente). Esta marca solo es válida para las operaciones de blit. |
| DDFXCAPS_BLTSTRETCHX | Admite la extensión arbitraria de una superficie a lo largo del eje X (horizontalmente). Esta marca solo es válida para las operaciones de blit. |
| DDFXCAPS_BLTSTRETCHXN | Admite el ajuste entero (x1, x2, etc.) de una superficie a lo largo del eje X (horizontalmente). Esta marca solo es válida para las operaciones de blit. |
| DDFXCAPS_BLTSTRETCHY | Admite la extensión arbitraria de una superficie a lo largo del eje Y (verticalmente). Esta marca solo es válida para las operaciones de blit. |
| DDFXCAPS_BLTSTRETCHYN | Admite el ajuste entero (x1, x2, etc.) de una superficie a lo largo del eje Y (verticalmente). Esta marca solo es válida para las operaciones de blit. |
| DDFXCAPS_OVERLAYARITHSTRETCHY | Usa operaciones aritméticas, en lugar de técnicas de duplicación de píxeles, para estirar y reducir superficies durante una operación de superposición. Se produce a lo largo del eje Y (verticalmente). |
| DDFXCAPS_OVERLAYARITHSTRETCHYN | Usa operaciones aritméticas, en lugar de técnicas de duplicación de píxeles, para estirar y reducir superficies durante una operación de superposición. Se produce a lo largo del eje Y (verticalmente) y solo funciona para el ajuste entero (x1, x2, etc.). |
| DDFXCAPS_OVERLAYMIRRORLEFTRIGHT | Admite la creación de reflejo de superposiciones alrededor del eje vertical. |
| DDFXCAPS_OVERLAYMIRRORUPDOWN | Admite la creación de reflejo de superposiciones en el eje horizontal. |
| DDFXCAPS_OVERLAYSHRINKX | Admite la reducción arbitraria de una superficie a lo largo del eje X (horizontalmente). Esta marca solo es válida para DDSCAPS_OVERLAY superficies. Esta marca indica solo las capacidades de una superficie; no indica que la reducción está disponible. |
| DDFXCAPS_OVERLAYSHRINKXN | Admite la reducción de enteros (x1, x2, etc.) de una superficie a lo largo del eje X (horizontalmente). Esta marca solo es válida para DDSCAPS_OVERLAY superficies. Esta marca indica solo las capacidades de una superficie; no indica que la reducción está disponible. |
| DDFXCAPS_OVERLAYSHRINKY | Admite la reducción arbitraria de una superficie a lo largo del eje Y (verticalmente). Esta marca solo es válida para DDSCAPS_OVERLAY superficies. Esta marca indica solo las capacidades de una superficie; no indica que la reducción está disponible. |
| DDFXCAPS_OVERLAYSHRINKYN | Admite la reducción de enteros (x1, x2, etc.) de una superficie a lo largo del eje Y (verticalmente). Esta marca solo es válida para DDSCAPS_OVERLAY superficies. Esta marca indica solo las capacidades de una superficie; no indica que la reducción está disponible. |
| DDFXCAPS_OVERLAYSTRETCHX | Admite la extensión arbitraria de una superficie a lo largo del eje X (horizontalmente). Esta marca solo es válida para DDSCAPS_OVERLAY superficies. Esta marca indica solo las capacidades de una superficie; no indica que la extensión está disponible. |
| DDFXCAPS_OVERLAYSTRETCHXN | Admite el ajuste entero (x1, x2, etc.) de una superficie a lo largo del eje X (horizontalmente). Esta marca solo es válida para DDSCAPS_OVERLAY superficies. Esta marca indica solo las capacidades de una superficie; no indica que la extensión está disponible. |
| DDFXCAPS_OVERLAYSTRETCHY | Admite la extensión arbitraria de una superficie a lo largo del eje Y (verticalmente). Esta marca solo es válida para DDSCAPS_OVERLAY superficies. Esta marca indica solo las capacidades de una superficie; no indica que la extensión está disponible. |
| DDFXCAPS_OVERLAYSTRETCHYN | Admite el ajuste entero (x1, x2, etc.) de una superficie a lo largo del eje Y (verticalmente). Esta marca solo es válida para DDSCAPS_OVERLAY superficies. Esta marca indica solo las capacidades de una superficie; no indica que la extensión está disponible. |
dwFXAlphaCaps
Este miembro y sus marcas están obsoletos y el controlador no debe usarlo.
dwPalCaps
Especifique las funcionalidades de paleta del controlador. El controlador debe establecer el bit DDPCAPS_Xxx adecuado para cada funcionalidad que admita. Las marcas DDPCAPS_Xxx se definen en ddraw.h. Actualmente, el entorno de ejecución de DirectDraw omite estas funcionalidades.
dwSVCaps
Especifique las funcionalidades de visión estéreo del controlador. El controlador debe establecer el bit DDSVCAPS_Xxx adecuado para cada funcionalidad que admita.
| Marca | Significado |
|---|---|
| DDSVCAPS_ENIGMA | La vista estéreo se logra mediante la codificación Enigma. |
| DDSVCAPS_FLICKER | La vista estéreo se logra con parpadeo de alta frecuencia. |
| DDSVCAPS_REDBLUE | La vista estéreo se logra cuando el visor mira la imagen a través de filtros rojos y azules colocados sobre los ojos izquierdo y derecho. Todas las imágenes deben adaptar sus espacios de color para este proceso. |
| DDSVCAPS_SPLIT | La vista estéreo se logra con tecnología de pantalla dividida. |
dwAlphaBltConstBitDepths
Reservado para uso del sistema. El controlador debe omitir este miembro.
dwAlphaBltPixelBitDepths
Reservado para uso del sistema. El controlador debe omitir este miembro.
dwAlphaBltSurfaceBitDepths
Reservado para uso del sistema. El controlador debe omitir este miembro.
dwAlphaOverlayConstBitDepths
Reservado para uso del sistema. El controlador debe omitir este miembro.
dwAlphaOverlayPixelBitDepths
Reservado para uso del sistema. El controlador debe omitir este miembro.
dwAlphaOverlaySurfaceBitDepths
Reservado para uso del sistema. El controlador debe omitir este miembro.
dwZBufferBitDepths
Indica una marca que especifica las profundidades del búfer Z admitidas por el controlador. Este puede ser uno o varios de los valores siguientes:
| Marca | Significado |
|---|---|
| DDBD_8 | El controlador admite un búfer de profundidad de 8bpp. |
| DDBD_16 | El controlador admite un búfer de profundidad de 16bpp. |
| DDBD_24 | El controlador admite un búfer de profundidad de 24bpp. |
| DDBD_32 | El controlador admite un búfer de profundidad de 32bpp. |
dwVidMemTotal
Especifica la cantidad total de memoria para mostrar, en bytes.
dwVidMemFree
Especifica el número de bytes de memoria de visualización libre. El controlador establece este miembro una vez durante la inicialización en el mismo valor que devuelve en el miembro dwVidMemTotal . DirectDraw lo actualiza cada vez que la aplicación realiza una asignación de memoria.
dwMaxVisibleOverlays
Especifica el número máximo de superposiciones visibles.
dwCurrVisibleOverlays
Especifica el número actual de superposiciones visibles.
dwNumFourCCCodes
Especifica el número de códigos FOURCC que admite el controlador.
dwAlignBoundarySrc
Especifica la alineación del rectángulo de origen. Opcionalmente, el controlador puede establecer este miembro. Si el controlador establece este miembro, el valor de coordenada superior izquierda del rectángulo de origen de superposición debe ser un múltiplo de dwAlignBoundarySrc.
dwAlignSizeSrc
Especifica el tamaño del rectángulo de origen, en bytes. Opcionalmente, el controlador puede establecer este miembro. Si el controlador establece este miembro, el ancho del rectángulo de origen de superposición debe ser un múltiplo de dwAlignSizeSrc.
dwAlignBoundaryDest
Especifica la alineación del rectángulo de destino. Opcionalmente, el controlador puede establecer este miembro. Si el controlador establece este miembro, el valor de coordenada superior izquierda del rectángulo de destino superpuesto debe ser un múltiplo de dwAlignBoundaryDest.
dwAlignSizeDest
Especifica el tamaño de bytes del rectángulo de destino. Opcionalmente, el controlador puede establecer este miembro. Si el controlador establece este miembro, el ancho del rectángulo de destino superpuesto debe ser un múltiplo de dwAlignSizeDest.
dwAlignStrideAlign
Reservado para uso del sistema y debe omitirlo el controlador.
dwRops[DD_ROP_SPACE]
Especifica una matriz de DD_ROP_SPACE DWORD que juntas pueden contener marcas para indicar las ROP que admite el controlador. El controlador debe establecer el campo de bits para cada ROP correspondiente que admita. Consulte la documentación de Microsoft Windows SDK para obtener información sobre las ROP.
ddsCaps
Especifica una estructura DDSCAPS que describe los tipos de superficies que admite el controlador.
dwMinOverlayStretch
Especifica el factor de extensión de superposición mínimo multiplicado por 1000. Por ejemplo, un factor de 1.3 debe almacenarse como 1300. El controlador de pantalla debe establecer el factor mínimo mínimo real al que el hardware gráfico puede reducir la superposición. Si el hardware gráfico no tiene ninguna limitación mínima, establezca en 1.
dwMaxOverlayStretch
Especifica el factor de extensión de superposición máximo multiplicado por 1000. Por ejemplo, un factor de 1.3 debe almacenarse como 1300. El controlador de pantalla debe establecer el factor máximo en el máximo real al que el hardware gráfico puede estirar la superposición. Si el hardware gráfico no tiene ninguna limitación máxima, establezca en 32000.
dwMinLiveVideoStretch
Especifica el factor de extensión de vídeo en directo mínimo multiplicado por 1000. Por ejemplo, un factor de 1.3 debe almacenarse como 1300.
dwMaxLiveVideoStretch
Especifica el factor máximo de extensión de vídeo en directo multiplicado por 1000. Por ejemplo, un factor de 1.3 debe almacenarse como 1300.
dwMinHwCodecStretch
Especifica el factor de códec de códec mínimo multiplicado por 1000. Por ejemplo, un factor de 1.3 debe almacenarse como 1300.
dwMaxHwCodecStretch
Especifica el factor de códec de códec máximo multiplicado por 1000. Por ejemplo, un factor de 1.3 debe almacenarse como 1300.
dwReserved1
Reservado para uso del sistema. El controlador debe omitir este miembro.
dwReserved2
Reservado para uso del sistema. El controlador debe omitir este miembro.
dwReserved3
Reservado para uso del sistema. El controlador debe omitir este miembro.
dwSVBCaps
Indica un conjunto de marcas que especifican las funcionalidades específicas del controlador para las ranuras system-memory-to-display-memory. El controlador debe orar bit a bit las marcas DDCAPS_Xxx adecuadas (vea el miembro dwCaps ) para indicar los tipos de operaciones de blit que admite al dividir desde la memoria del sistema para mostrar la memoria.
dwSVBCKeyCaps
Indica un conjunto de marcas que especifican funcionalidades de clave de color del controlador para las ranuras system-memory-to-display-memory. El controlador debe orar bit a bit las marcas DDCKEYCAPS_Xxx adecuadas (vea el miembro dwCKeyCaps ) para indicar los tipos de operaciones de clave de color que admite al dividir desde la memoria del sistema para mostrar la memoria.
dwSVBFXCaps
Indica un conjunto de marcas que especifican las funcionalidades fx del controlador para las ranuras system-memory-to-display-memory. El controlador debe orar bit a bit las marcas DDFXCAPS_Xxx adecuadas (vea el miembro dwFXCaps ) para indicar los tipos de efectos que admite al transferir la memoria del sistema a la memoria del sistema.
dwSVBRops[DD_ROP_SPACE]
Especifica una matriz de DD_ROP_SPACE DWORD que juntas pueden contener marcas para indicar las ROP que admite el controlador al realizar blits system-memory to-display-memory. El controlador debe establecer el campo de bits para cada ROP correspondiente que admita. Consulte la documentación de Microsoft Windows SDK para obtener información sobre las ROP.
dwVSBCaps
Indica un conjunto de marcas que especifican funcionalidades específicas del controlador para las pantallas de memoria a memoria del sistema. El controlador debe orar bit a bit las marcas DDCAPS_Xxx adecuadas (vea el miembro dwCaps ) para indicar los tipos de operaciones de blit que admite al transferir la memoria de pantalla a la memoria del sistema.
dwVSBCKeyCaps
Indica un conjunto de marcas que especifican funcionalidades de clave de color del controlador para las pantallas de memoria a memoria del sistema. El controlador debe orar bit a bit las marcas DDCKEYCAPS_Xxx adecuadas (vea el miembro dwCKeyCaps ) para indicar los tipos de operaciones de clave de color que admite al transferir la memoria de pantalla a la memoria del sistema.
dwVSBFXCaps
Indica un conjunto de marcas que especifican las funcionalidades fx del controlador para las ranuras display-memory-to-system-memory. El controlador debe orar bit a bit las marcas DDFXCAPS_Xxx adecuadas (vea el miembro dwFXCaps ) para indicar los tipos de efectos que admite al transferir la memoria de pantalla a la memoria del sistema.
dwVSBRops[DD_ROP_SPACE]
Especifica una matriz de DD_ROP_SPACE DWORD que juntas pueden contener marcas para indicar las ROP que admite el controlador al realizar blits display-memory-to-system-memory. El controlador debe establecer el campo de bits para cada ROP correspondiente que admita. Consulte la documentación de Windows SDK para obtener información sobre las ROP.
dwSSBCaps
Indica un conjunto de marcas que especifican funcionalidades específicas del controlador para las ranuras system-memory-to-system-memory. El controlador debe orar bit a bit las marcas DDCAPS_Xxx adecuadas (vea el miembro dwCaps ) para indicar los tipos de operaciones de blit que admite al transferir la memoria del sistema a la memoria del sistema.
dwSSBCKeyCaps
Indica un conjunto de marcas que especifican funcionalidades de clave de color del controlador para las ranuras system-memory-to-system-memory. El controlador debe orar bit a bit las marcas DDCKEYCAPS_Xxx adecuadas (vea el miembro dwCKeyCaps ) para indicar los tipos de operaciones de clave de color que admite al transferir la memoria del sistema a la memoria del sistema.
dwSSBFXCaps
Indica un conjunto de marcas que especifican las funcionalidades fx del controlador para las ranuras de memoria del sistema a memoria del sistema. El controlador debe orar bit a bit las marcas DDFXCAPS_Xxx adecuadas (vea el miembro dwFXCaps ) para indicar los tipos de efectos que admite al transferir la memoria del sistema a la memoria del sistema.
dwSSBRops[DD_ROP_SPACE]
Especifica una matriz de DD_ROP_SPACE DWORD que juntos pueden contener marcas para indicar las ROP que admite el controlador al realizar las ranuras de memoria del sistema a memoria del sistema. El controlador debe establecer el campo de bits para cada ROP correspondiente que admita. Consulte la documentación de Windows SDK para obtener información sobre las ROP.
dwMaxVideoPorts
Especifica el número máximo de objetos VPE utilizables.
dwCurrVideoPorts
Especifica el número actual de objetos VPE usados. El controlador no necesita rellenar este miembro porque lo establece DirectDraw.
dwSVBCaps2
Especifica funcionalidades adicionales específicas del controlador para las ranuras system-memory-to-display-memory. Las marcas válidas son idénticas a las marcas relacionadas con la función blit usadas con el miembro dwCaps2 .
Comentarios
Esta sección contiene la estructura del controlador de DirectDraw cuyo nombre tiene el formato DDCORECAPS, que es el formulario que se usa en Windows 98/Me. Esta estructura es idéntica a aquella cuyo nombre tiene el formato DDNTCORECAPS, que es el formulario que se usa en Windows 2000 y versiones posteriores. El archivo include dx95type.h contiene un tipo definido de DDNTCORECAPS a DDCORECAPS.
Esta estructura refleja las primeras entradas de la estructura DDCAPS, pero tiene un tamaño fijo y no crece como hace DDCAPS.
El controlador inicializa DDCORECAPS cuando se inicializan los demás miembros de la estructura DD_HALINFO en su estructura DrvGetDirectDrawInfo . El entorno de ejecución de DirectDraw podría actualizar algunos miembros.
DirectDraw solicita funcionalidades adicionales del controlador mediante una llamada a la función DdGetDriverInfo que también se devuelve en la estructura de DD_HALINFO.
Requisitos
| Requisito | Valor |
|---|---|
| Header | ddrawi.h (incluye Ddrawi.h) |