PFND3DKMT_ENUMADAPTERS3 función de devolución de llamada (d3dkmthk.h)
La función de devolución de llamada PFND3DKMT_ENUMADAPTERS3 enumera los adaptadores de visualización y gráficos en el sistema.
Sintaxis
PFND3DKMT_ENUMADAPTERS3 Pfnd3dkmtEnumadapters3;
NTSTATUS Pfnd3dkmtEnumadapters3(
[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 pEnumAdaptersy deben cerrarse con D3DKMTCloseAdapter.
Si no se establece ninguna de las marcas D3DKMT_ENUMADAPTERS3::Filter, se enumerarán los adaptadores, pero hay menos adaptadores que PFND3DKMT_ENUMADAPTERS2 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 |
| encabezado de | d3dkmthk.h |