Compartilhar via


Método IDXGIFactory::CreateSoftwareAdapter (dxgi.h)

Crie uma interface de adaptador que represente um adaptador de software.

Sintaxe

HRESULT CreateSoftwareAdapter(
        HMODULE      Module,
  [out] IDXGIAdapter **ppAdapter
);

Parâmetros

Module

Tipo: HMODULE

Manipule para a dll do adaptador de software. O HMODULE pode ser obtido com GetModuleHandle ou LoadLibrary.

[out] ppAdapter

Tipo: IDXGIAdapter**

Endereço de um ponteiro para um adaptador (consulte IDXGIAdapter).

Valor retornado

Tipo: HRESULT

Um código de retorno que indica êxito ou falha.

Comentários

Um adaptador de software é uma DLL que implementa a totalidade de uma interface de driver de dispositivo, além de emulação, se necessário, de componentes gráficos no modo kernel para Windows. Detalhes sobre como implementar um adaptador de software podem ser encontrados no Kit de Desenvolvimento de Driver do Windows Vista. Essa é uma tarefa de desenvolvimento muito complexa e não é recomendada para leitores gerais.

Chamar esse método incrementará a contagem de referência do módulo em um. A contagem de referência pode ser decrementada chamando FreeLibrary.

O cenário de chamada típico é chamar LoadLibrary, passar o identificador para CreateSoftwareAdapter e chamar FreeLibrary imediatamente na DLL e esquecer o HMODULE da DLL. Como o adaptador de software chama FreeLibrary quando ele é destruído, o tempo de vida da DLL agora pertencerá ao adaptador e o aplicativo estará livre de qualquer consideração adicional de seu tempo de vida.

Requisitos

   
Plataforma de Destino Windows
Cabeçalho dxgi.h
Biblioteca DXGI.lib

Confira também

IDXGIFactory