Función D3DKMTEnumAdapters3 (d3dkmthk.h)
Proporciona información para enumerar adaptadores de visualización y gráficos en el sistema.
Sintaxis
NTSTATUS D3DKMTEnumAdapters3(
[in/out] D3DKMT_ENUMADAPTERS3 *unnamedParam1
);
Parámetros
[in/out] unnamedParam1
Estructura D3DKMT_ENUMADAPTERS3. El autor de la llamada pasa el tamaño de la matriz y un espacio de matriz vacío. El autor de la llamada comprueba que hay suficiente espacio en la matriz, rellena la matriz y devuelve la cantidad de la matriz que se usó.
Valor devuelto
Esta función devuelve NTSTATUS.
| Código devuelto | Descripción |
|---|---|
| STATUS_BUFFER_TOO_SMALL | La matriz proporcionada es demasiado pequeña para recibir todos los adaptadores. |
| STATUS_INVALID_PARAMETER | El miembro pEnumAdapters es null o es una región de memoria no válida. |
| STATUS_NO_MEMORY | No se puede asignar memoria para satisfacer la operación. |
Observaciones
Cuando D3DKMT_ENUMADAPTERS3::p Adapters es NULL, D3DKMT_ENUMADAPTERS3::NumAdapters se establece en el número máximo de adaptadores admitidos. Normalmente, las llamadas invocarán el método , en primer lugar, para recuperar el número máximo de adaptadores admitidos.
Cuando el destinatario enumera correctamente los adaptadores, se hace responsable de administrar explícitamente la duración del adaptador D3DKMT_HANDLEs. Estos identificadores se devuelven al destinatario a través de pEnumAdapters y deben cerrarse con D3DKMTCloseAdapter.
Si no se establece ninguna de las marcas D3DKMT_ENUMADAPTERS3::Filter, los adaptadores seguirán enumerando los adaptadores, pero hay menos adaptadores que D3DKMTEnumAdapters2 enumeraciones. Los adaptadores computeOnly se dejan fuera de la enumeración predeterminada, para evitar interrumpir las aplicaciones. Los adaptadores displayOnly también se dejan fuera de la enumeración predeterminada.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Windows 10, versión 2004 |
| de la plataforma de destino de |
Windows |
| encabezado de |
d3dkmthk.h (incluya D3dkmthk.h) |
| biblioteca de |
onecoreuap.lib |
| DLL de |
Gdi32.dll |