Função NtGdiDdCreateSurfaceObject
[Essa função está sujeita a alterações com cada revisão do sistema operacional. Em vez disso, use o Microsoft DirectDraw e o Microsoft Direct3DAPIs; essas APIs isolam os aplicativos dessas alterações do sistema operacional e ocultam muitas outras dificuldades envolvidas na interação diretamente com drivers de exibição.]
Cria um objeto de superfície no modo kernel que representa o objeto de superfície do modo de usuário referenciado por puSurfaceLocal.
Sintaxe
HANDLE APIENTRY NtGdiDdCreateSurfaceObject(
_In_ HANDLE hDirectDrawLocal,
_In_ HANDLE hSurface,
_In_ PDD_SURFACE_LOCAL puSurfaceLocal,
_In_ PDD_SURFACE_MORE puSurfaceMore,
_In_ PDD_SURFACE_GLOBAL puSurfaceGlobal,
_In_ BOOL bComplete
);
Parâmetros
-
hDirectDrawLocal [in]
-
Identificador para o objeto DirectDraw no modo kernel.
-
hSurface [in]
-
Identificador anterior para a mesma superfície. Usado se a superfície estiver sendo recriada após uma opção de modo.
-
puSurfaceLocal [in]
-
Ponteiro para a estrutura DD_SURFACE_LOCAL que representa o objeto de superfície do modo de usuário do DirectDraw ao qual associar a memória alocada. Consulte a documentação do DDK para obter detalhes.
-
puSurfaceMore [in]
-
Ponteiro para a estrutura DD_SURFACE_MORE que contém dados locais adicionais para cada objeto de superfície individual. Consulte a documentação do DDK para obter detalhes.
-
puSurfaceGlobal [in]
-
Ponteiro para a estrutura DD_SURFACE_GLOBAL que contém dados de superfície compartilhados globalmente com várias superfícies. Consulte a documentação do DDK para obter detalhes.
-
bComplete [in]
-
Sinalizador de conclusão de objeto no modo kernel. Pode ser um dos valores a seguir.
-
(TRUE)
-
Conclua todo o processamento referente à representação do modo kernel.
-
(FALSE)
-
Crie o objeto , mas não configure dados internos, como o ponteiro de memória. Os objetos criados usando FALSE podem ser anexados usando NtGdiDdAttachSurface e são concluídos por uma chamada para NtGdiDdCreateSurface.
Valor retornado
Se tiver êxito, essa função retornará um identificador para a representação de superfície do modo kernel; caso contrário, retornará NULL.
Comentários
Os aplicativos são aconselhados a usar as APIs DirectDraw e Direct3D para criar e gerenciar objetos de dispositivo gráfico. Essas construções abstraem o processo de criação do dispositivo de maneira simplificada e independente do sistema operacional.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte |
Windows 2000 Professional [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte |
Windows 2000 Server [somente aplicativos da área de trabalho] |
| Cabeçalho |
|
Confira também