PFND3DKMT_ENUMADAPTERS3 función de devolución de llamada (d3dkmthk.h)

Artículo
02/25/2024

La función de devolución de llamada PFND3DKMT_ENUMADAPTERS3 enumera los adaptadores de pantalla y gráficos del 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 destinatario comprueba que hay suficiente espacio en la matriz, rellena la matriz y pasa la cantidad de la matriz que se usó.

Valor devuelto

Esta función devuelve NTSTATUS.

Código de retorno	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 de otro modo una región de memoria no válida.
STATUS_NO_MEMORY	No se puede asignar memoria para satisfacer la operación.

Comentarios

Cuando D3DKMT_ENUMADAPTERS3::p Adapters es null, D3DKMT_ENUMADAPTERS3::NumAdapters se establece en el número máximo de adaptadores admitidos. Normalmente, los destinatarios invocarán el método , primero, 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.

Establecer ninguna de las marcas D3DKMT_ENUMADAPTERS3::Filter seguirá enumerando adaptadores, pero hay menos adaptadores que PFND3DKMT_ENUMADAPTERS2 enumeraciones. Los adaptadores computeOnly se quedan fuera de la enumeración predeterminada para evitar interrumpir las aplicaciones. Los adaptadores displayOnly también se quedan fuera de la enumeración predeterminada.