Compartir a través de


Interfaz IDirectDrawSurface7 (ddraw.h)

Las aplicaciones usan los métodos de la interfaz IDirectDrawSurface7 para crear objetos DirectDrawSurface y trabajar con variables de nivel de sistema. Esta sección es una referencia a los métodos de esta interfaz.

Herencia

La interfaz IDirectDrawSurface7 hereda de la interfaz IUnknown . IDirectDrawSurface7 también tiene estos tipos de miembros:

Métodos

La interfaz IDirectDrawSurface7 tiene estos métodos.

 
IDirectDrawSurface7::AddAttachedSurface

Adjunta la superficie z-buffer especificada a esta superficie.
IDirectDrawSurface7::AddOverlayDirtyRect

El método IDirectDrawSurface7::AddOverlayDirtyRect no está implementado actualmente.
IDirectDrawSurface7::Blt

Realiza una transferencia de bloques de bits (bitblt). Este método no admite el almacenamiento en búfer z ni la combinación alfa durante las operaciones bitblt.
IDirectDrawSurface7::BltBatch

El método IDirectDrawSurface7::BltBatch no está implementado actualmente.
IDirectDrawSurface7::BltFast

Realiza una copia de origen bitblt o bitblt transparente mediante una clave de color de origen o una clave de color de destino.
IDirectDrawSurface7::ChangeUniquenessValue

Actualiza manualmente el valor de unicidad de esta superficie.
IDirectDrawSurface7::D eleteAttachedSurface

Desasocia una o varias superficies adjuntas.
IDirectDrawSurface7::EnumAttachedSurfaces

Enumera todas las superficies que están conectadas a esta superficie.
IDirectDrawSurface7::EnumOverlayZOrders

Enumera las superficies de superposición en el destino especificado. Puede enumerar las superposiciones en orden de front-to-back o back-to-front.
IDirectDrawSurface7::Flip

Hace que la memoria de superficie asociada a la superficie DDSCAPS_BACKBUFFER se asote a la superficie del búfer frontal.
IDirectDrawSurface7::FreePrivateData

Libera los datos privados especificados asociados a esta superficie.
IDirectDrawSurface7::GetAttachedSurface

Obtiene la superficie adjunta que tiene las funcionalidades especificadas e incrementa el recuento de referencias de la interfaz recuperada.
IDirectDrawSurface7::GetBltStatus

Obtiene el estado de una operación de transferencia de bloques de bits (bitblt).
IDirectDrawSurface7::GetCaps

Recupera las funcionalidades de esta superficie. Estas funcionalidades no están necesariamente relacionadas con las funcionalidades del dispositivo de visualización.
IDirectDrawSurface7::GetClipper

Recupera el objeto DirectDrawClipper asociado a esta superficie e incrementa el recuento de referencias del clipper devuelto.
IDirectDrawSurface7::GetColorKey

Recupera el valor de clave de color de esta superficie.
IDirectDrawSurface7::GetDC

Crea un identificador compatible con GDI de un contexto de dispositivo para esta superficie.
IDirectDrawSurface7::GetDDInterface

Recupera una interfaz para el objeto DirectDraw que se usó para crear esta superficie.
IDirectDrawSurface7::GetFlipStatus

Recupera el estado sobre si esta superficie ha terminado su proceso de volteo.
IDirectDrawSurface7::GetLOD

Recupera el nivel máximo de detalle (LOD) establecido actualmente para una superficie de mapa mip administrado. Este método solo se realiza correctamente en texturas administradas.
IDirectDrawSurface7::GetOverlayPosition

Recupera las coordenadas de visualización de esta superficie. Este método se usa en una superficie de superposición visible y activa (es decir, una superficie que tiene establecida la marca DDSCAPS_OVERLAY).
IDirectDrawSurface7::GetPalette

Recupera el objeto DirectDrawPalette asociado a esta superficie e incrementa el recuento de referencias de la paleta devuelta.
IDirectDrawSurface7::GetPixelFormat

Recupera el formato de color y píxel de esta superficie.
IDirectDrawSurface7::GetPriority

Recupera la prioridad de administración de texturas para esta textura. Este método solo se realiza correctamente en texturas administradas.
IDirectDrawSurface7::GetPrivateData

Copia los datos privados asociados a esta superficie en un búfer proporcionado.
IDirectDrawSurface7::GetSurfaceDesc

Recupera una descripción de esta superficie en su condición actual.
IDirectDrawSurface7::GetUniquenessValue

Recupera el valor de unicidad actual para esta superficie.
IDirectDrawSurface7::Initialize

Inicializa un objeto DirectDrawSurface.
IDirectDrawSurface7::IsLost

Determina si se ha liberado la memoria expuesta asociada a un objeto DirectDrawSurface.
IDirectDrawSurface7::Lock

Obtiene un puntero a la memoria expuesta.
IDirectDrawSurface7::P ageLock

Impide que una superficie de memoria del sistema se pagina mientras una operación de transferencia de bloques de bits (bitblt) que usa transferencias de acceso directo a memoria (DMA) hacia o desde la memoria del sistema está en curso.
IDirectDrawSurface7::P ageUnlock

Desbloquea una superficie de memoria del sistema, que luego permite paginarlo.
IDirectDrawSurface7::ReleaseDC

Libera el identificador de un contexto de dispositivo que se obtuvo anteriormente mediante el método IDirectDrawSurface7::GetDC.
IDirectDrawSurface7::Restore

Restaura una superficie que se ha perdido. Esto ocurre cuando se libera la memoria expuesta asociada al objeto DirectDrawSurface.
IDirectDrawSurface7::SetClipper

Adjunta un objeto clipper a, o elimina uno de esta superficie.
IDirectDrawSurface7::SetColorKey

Establece el valor de clave de color del objeto DirectDrawSurface si el hardware admite claves de color por superficie.
IDirectDrawSurface7::SetLOD

Establece el nivel máximo de detalle (LOD) para una superficie de mapa mip administrado. Este método solo se realiza correctamente en texturas administradas.
IDirectDrawSurface7::SetOverlayPosition

Cambia las coordenadas de visualización de una superficie superpuesta.
IDirectDrawSurface7::SetPalette

Adjunta un objeto de paleta a (o desasocia uno de) una superficie. La superficie usa esta paleta para todas las operaciones posteriores. El cambio de paleta tiene lugar inmediatamente, sin tener en cuenta el tiempo de actualización.
IDirectDrawSurface7::SetPriority

Asigna la prioridad de administración de texturas para esta textura. Este método solo se realiza correctamente en texturas administradas.
IDirectDrawSurface7::SetPrivateData

Asocia datos a la superficie que está pensada para su uso por la aplicación, no por DirectDraw. Los datos se pasan por valor y se pueden asociar varios conjuntos de datos a una sola superficie.
IDirectDrawSurface7::SetSurfaceDesc

Establece las características de una superficie existente.
IDirectDrawSurface7::Unlock

Notifica a DirectDraw que las manipulaciones de superficie directa están completas.
IDirectDrawSurface7::UpdateOverlay

Cambia la posición o modifica los atributos visuales de una superficie superpuesta. Estas superficies deben tener establecida la marca DDSCAPS_OVERLAY.
IDirectDrawSurface7::UpdateOverlayDisplay

El método IDirectDrawSurface7::UpdateOverlayDisplay no está implementado actualmente.
IDirectDrawSurface7::UpdateOverlayZOrder

Establece el orden z de una superposición.

Comentarios

Los métodos de la interfaz IDirectDrawSurface7 se pueden organizar en los siguientes grupos:

Grupo Métodos
Asignar memoria Inicializar, IsLost y Restaurar
Adjuntar superficies AddAttachedSurface, DeleteAttachedSurface, EnumAttachedSurfaces y GetAttachedSurface
BitBltting Blt, BltBatch, BltFast y GetBltStatus
Keying de color GetColorKey y SetColorKey
Contextos de dispositivo GetDC y ReleaseDC
Voltear Flip y GetFlipStatus
Superficies de bloqueo Bloquear, PageLock, PageUnlock y Desbloquear
Varios GetDDInterface
Superposiciones AddOverlayDirtyRect, EnumOverlayZOrders, GetOverlayPosition, SetOverlayPosition, UpdateOverlay, UpdateOverlayDisplay y UpdateOverlayZOrder
Datos de superficie privada FreePrivateData, GetPrivateData y SetPrivateData
Funcionalidades de Surface GetCaps
Clipper de Surface GetClipper y SetClipper
Características de superficie ChangeUniquenessValue, GetPixelFormat, GetSurfaceDesc, GetUniquenessValue y SetSurfaceDesc
Paletas de Superficie GetPalette y SetPalette
Texturas GetLOD, GetPriority, SetLOD y SetPriority
 

La interfaz IDirectDrawSurface7 amplía las características de las versiones anteriores de la interfaz ofreciendo métodos que ofrecen una mejor administración de superficies y facilidad de uso. Muchos métodos de esta interfaz aceptan parámetros ligeramente diferentes que sus homólogos en versiones anteriores de la interfaz. Siempre que un método de interfaz IDirectDrawSurface3 pueda aceptar una estructura DDSURFACEDESC o una interfaz IDirectDrawSurface3 , los métodos de IDirectDrawSurface7 aceptan una estructura DDSURFACEDESC2 o una interfaz IDirectDrawSurface7 , en su lugar.

Utilice el tipo de datos LPDIRECTDRAWSURFACE, LPDIRECTDRAWSURFACE2, LPDIRECTDRAWSURFACE3, LPDIRECTDRAWSURFACE4 o LPDIRECTDRAWSURFACE7 para declarar una variable que apunte a varias interfaces de objeto DirectDrawSurface. El archivo de encabezado Ddraw.h declara estos tipos de datos con el código siguiente:


typedef struct IDirectDrawSurface     FAR *LPDIRECTDRAWSURFACE;
typedef struct IDirectDrawSurface2    FAR *LPDIRECTDRAWSURFACE2;
typedef struct IDirectDrawSurface3    FAR *LPDIRECTDRAWSURFACE3;
typedef struct IDirectDrawSurface4    FAR *LPDIRECTDRAWSURFACE4;
typedef struct IDirectDrawSurface7    FAR *LPDIRECTDRAWSURFACE7;

Requisitos

   
Plataforma de destino Windows
Encabezado ddraw.h