PDD_VPORTCB_GETVPORTCONNECT función de devolución de llamada (ddrawint.h)
La función de devolución de llamada DdVideoPortGetConnectInfo devuelve las conexiones admitidas por el objeto VPE especificado.
Sintaxis
PDD_VPORTCB_GETVPORTCONNECT PddVportcbGetvportconnect;
DWORD PddVportcbGetvportconnect(
PDD_GETVPORTCONNECTDATA unnamedParam1
)
{...}
Parámetros
unnamedParam1
Apunta a una estructura de DD_GETVPORTCONNECTDATA que contiene la información necesaria para que el controlador devuelva los datos de conexión del objeto VPE.
Valor devuelto
DdVideoPortGetConnectInfo devuelve uno de los siguientes códigos de devolución de llamada:
Comentarios
DdVideoPortGetConnectInfo debe implementarse en los controladores de DirectDraw que admiten VPE.
DirectDraw llama a DdVideoPortGetConnectInfo para obtener el número de conexiones admitidas por el objeto VPE especificado y las características de cada conexión. Se llama a DdVideoPortGetConnectInfo dos veces para el objeto VPE especificado:
- En la primera llamada, el miembro lpConnect de la estructura de DD_GETVPORTCONNECTDATA en lpGetConnect es NULL. El controlador debe escribir el número de conexiones que admite el objeto VPE en el miembro dwNumEntries de DD_GETVPORTCONNECTDATA. Tras la devolución, DirectDraw asignará este número de estructuras DDVIDEOPORTCONNECT para pasar la segunda llamada a DdVideoPortGetConnectInfo.
- En la segunda llamada, lpConnect apunta a la matriz de estructuras DDVIDEOPORTCONNECT asignadas. El controlador debe rellenar cada estructura para describir cada conexión que admita el objeto VPE. El controlador también debe devolver el número de conexiones admitidas en dwNumEntries. Tenga en cuenta que el controlador está garantizado que el búfer al que puntos lpConnect es lo suficientemente grande como para contener la información de conexión que se solicita.
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Escritorio |
| Encabezado | ddrawint.h (incluya Winddi.h) |