Share via

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

  • Artículo

Cree una interfaz de adaptador que represente un adaptador de software.

Sintaxis

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

Parámetros

Module

Tipo: HMODULE

Identificador del archivo DLL del adaptador de software. HMODULE se puede obtener con GetModuleHandle o LoadLibrary.

[out] ppAdapter

Tipo: IDXGIAdapter**

Dirección de un puntero a un adaptador (consulte IDXGIAdapter).

Valor devuelto

Tipo: HRESULT

Código de retorno que indica si se ha realizado correctamente o no.

Comentarios

Un adaptador de software es un archivo DLL que implementa la totalidad de una interfaz de controlador de dispositivo, además de la emulación, si es necesario, de componentes gráficos en modo kernel para Windows. Puede encontrar detalles sobre cómo implementar un adaptador de software en el Kit de desarrollo de controladores de Windows Vista. Se trata de una tarea de desarrollo muy compleja y no se recomienda para lectores generales.

Al llamar a este método, se incrementará el recuento de referencias del módulo en uno. El recuento de referencias se puede disminuir llamando a FreeLibrary.

El escenario de llamada típico consiste en llamar a LoadLibrary, pasar el identificador a CreateSoftwareAdapter y, a continuación, llamar inmediatamente a FreeLibrary en el archivo DLL y olvidar el HMODULE del archivo DLL. Dado que el adaptador de software llama a FreeLibrary cuando se destruye, la duración del archivo DLL ahora será propiedad del adaptador y la aplicación está libre de cualquier consideración adicional de su duración.

Requisitos

   
Plataforma de destino Windows
Encabezado dxgi.h
Library DXGI.lib

Consulte también

IDXGIFactory