estrutura DD_NTPRIVATEDRIVERCAPS (ddrawint.h)

A estrutura DD_NTPRIVATEDRIVERCAPS permite que o driver altere o comportamento do Microsoft DirectDraw quando o DirectDraw está criando superfícies.

Sintaxe

typedef struct DD_NTPRIVATEDRIVERCAPS {
  DWORD dwSize;
  DWORD dwPrivateCaps;
} DD_NTPRIVATEDRIVERCAPS;

Membros

dwSize

Especifica o tamanho em bytes dessa estrutura DD_NTPRIVATEDRIVERCAPS.

dwPrivateCaps

Indica como o DirectDraw deve criar a superfície.

DDHAL_PRIVATECAP_AUTOMICSURFACECREATION

Quando esse sinalizador é definido, ele indica que o driver solicita que DdCreateSurface seja chamado apenas uma vez quando o aplicativo cria uma cadeia de inversão complexa usando uma única chamada CreateSurface . Nesse caso, o membro lplpSList da estrutura DD_CREATESURFACEDATA aponta para uma lista de superfícies a serem criadas (em vez de uma única superfície) e dwSCnt contém o número de superfícies na lista.

DDHAL_PRIVATECAP_NOTIFYPRIMARYCREATION

Quando esse sinalizador é definido, a função DdCreateSurface do driver é chamada ao criar uma superfície primária. Se esse sinalizador não estiver definido, a função DdCreateSurface do driver não será chamada.

Comentários

O comportamento do DirectDraw emula as técnicas de criação de superfície empregadas pelo DirectDraw ao criar superfícies para o Microsoft Windows 98/Me.

Quando o sinalizador DDHAL_PRIVATECAP_AUTOMICSURFACECREATION não está definido, o DirectDraw executa a criação da superfície usando o método original, ou seja, ele chama a função DdCreateSurface do driver uma vez para cada superfície que está sendo criada.

Quando o sinalizador DDHAL_PRIVATECAP_NOTIFYPRIMARYCREATION não está definido, o DirectDraw executa a criação da superfície primária usando o método original, ou seja, ele não chama o driver ao criar uma superfície primária.

Requisitos

Requisito	Valor
Cabeçalho	ddrawint.h (inclua Winddi.h)

Confira também

DD_CREATESURFACEDATA

DdCreateSurface