Función D3DKMTEnumAdapters2 (d3dkmthk.h)
La función D3DKMTEnumAdapters2 proporciona información para enumerar todos los adaptadores de gráficos y de pantalla en el sistema.
Sintaxis
NTSTATUS D3DKMTEnumAdapters2(
const D3DKMT_ENUMADAPTERS2 *unnamedParam1
);
Parámetros
unnamedParam1
[dentro, fuera] Puntero a una estructura D3DKMT_ENUMADAPTERS2 en la que se proporciona información sobre los adaptadores en el sistema. Vea comentarios.
Valor devuelto
D3DKMTEnumAdapters2 devuelve STATUS_SUCCESS al éxito o un error como uno de los siguientes.
| Código devuelto | Descripción |
|---|---|
| STATUS_BUFFER_TOO_SMALL | La matriz proporcionada es demasiado pequeña para recibir todos los adaptadores. |
| STATUS_INVALID_PARAMETER | pAdapters 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
En la entrada, NumAdapters especifica cuántos adaptadores se pueden devolver en la matriz vacía a la que puntos de pAdapters. Si D3DKMT_ENUMADAPTERS2 devuelve STATUS_SUCCESS:
- Si
pAdapters no es NULL, NumAdapters contendrán el número de adaptadores devueltos en la matriz de pAdapters de . - Si pAdapters es NULL, NumAdapters contendrá el número máximo de adaptadores admitidos.
Si D3DKMT_ENUMADAPTERS2 devuelve un error, NumAdapters no está definido.
D3DKMTEnumAdapters2 se suele llamar dos veces:
Para la primera llamada, establezca pAdapters en NULL. D3DKMTEnumAdapters2 escribirá el número máximo de adaptadores admitidos en NumAdapters.
Para la segunda llamada, establezca NumAdapters en el valor devuelto en la primera llamada y establezca pAdapters para que apunten a una matriz de estructuras NumAdaptersD3DKMT_ENUMADAPTERS2. D3DKMTEnumAdapters2 rellenará la matriz y devolverá el número de estructuras de matriz (adaptadores) que llenó.
Una vez que el autor de la llamada de D3DKMTEnumAdapters2 ha recibido correctamente una enumeración de los adaptadores, es responsabilidad del autor de la llamada administrar la duración del adaptador D3DKMT_HANDLEs. Estos identificadores se devuelven a través de pAdaptersy deben cerrarse con D3DKMTCloseAdapter.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Windows 8 |
| servidor mínimo admitido | Windows Server 2012 |
| de la plataforma de destino de |
Windows |
| encabezado de |
d3dkmthk.h (incluya D3dkmthk.h) |
| biblioteca de |
Gdi32.lib |
| DLL de |
Gdi32.dll |