Compartir a través de

Función DMLCreateDevice (directml.h)

  • Artículo

Crea un dispositivo DirectML para un dispositivo Direct3D 12 determinado.

Sintaxis

HRESULT DMLCreateDevice(
  ID3D12Device            *d3d12Device,
  DML_CREATE_DEVICE_FLAGS flags,
  REFIID                  riid,
  void                    **ppv
);

Parámetros

d3d12Device

Tipo: ID3D12Device*

Puntero a un dispositivo ID3D12Device que representa el dispositivo Direct3D 12 para crear el dispositivo DirectML. DirectML admite cualquier nivel de característica D3D y dispositivos Direct3D 12 creados en cualquier adaptador, incluido WARP. Sin embargo, no todas las características de DirectML pueden estar disponibles en función de las funcionalidades del dispositivo Direct3D 12. Consulta IDMLDevice::CheckFeatureSupport para obtener más información.

Si la llamada a DMLCreateDevice es correcta, el dispositivo DirectML mantiene una referencia fuerte al dispositivo Direct3D 12 proporcionado.

flags

Tipo: DML_CREATE_DEVICE_FLAGS

Valor de DML_CREATE_DEVICE_FLAGS que especifica opciones adicionales de creación de dispositivos.

riid

Tipo: REFIID

Referencia al identificador único global (GUID) de la interfaz que desea devolver en el dispositivo. Se espera que sea el GUID de IDMLDevice.

ppv

Tipo: _COM_Outptr_opt_ void**

Puntero a un bloque de memoria que recibe un puntero al dispositivo. Esta es la dirección de un puntero a un IDMLDevice, que representa el dispositivo DirectML creado.

Valor devuelto

Tipo: HRESULT

Si la función se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

Se introdujo una versión más reciente de esta función, DMLCreateDevice1, en la versión 1.1.0 de DirectML. DMLCreateDevice equivale a llamar a DMLCreateDevice1 y proporcionar un valor minimumFeatureLevel de DML_FEATURE_LEVEL_1_0.

Requisitos

   
Cliente mínimo compatible Windows 10 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2016 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado directml.h
Library DirectML.lib
Archivo DLL DirectML.dll

Consulte también