PDD_VPORTCB_GETVPORTCONNECT fonction de rappel (ddrawint.h)
La fonction de rappel DdVideoPortGetConnectInfo retourne les connexions prises en charge par l’objet VPE spécifié.
Syntaxe
PDD_VPORTCB_GETVPORTCONNECT PddVportcbGetvportconnect;
DWORD PddVportcbGetvportconnect(
PDD_GETVPORTCONNECTDATA unnamedParam1
)
{...}
Paramètres
unnamedParam1
Pointe vers une structure DD_GETVPORTCONNECTDATA qui contient les informations requises pour que le pilote retourne les données de connexion de l’objet VPE.
Valeur retournée
DdVideoPortGetConnectInfo retourne l’un des codes de rappel suivants :
Remarques
DdVideoPortGetConnectInfo doit être implémenté dans les pilotes DirectDraw qui prennent en charge VPE.
DirectDraw appelle DdVideoPortGetConnectInfo pour obtenir le nombre de connexions prises en charge par l’objet VPE spécifié et les caractéristiques de chaque connexion. DdVideoPortGetConnectInfo est appelé deux fois pour l’objet VPE spécifié :
- Dans le premier appel, le membre lpConnect de la structure DD_GETVPORTCONNECTDATA à lpGetConnect est NULL. Le pilote doit écrire le nombre de connexions que l’objet VPE prend en charge dans le membre dwNumEntries de DD_GETVPORTCONNECTDATA. Au retour, DirectDraw alloue ce nombre de structures DDVIDEOPORTCONNECT pour passer le deuxième appel à DdVideoPortGetConnectInfo.
- Dans le deuxième appel, lpConnect pointe vers le tableau des structures DDVIDEOPORTCONNECT allouées. Le pilote doit remplir chaque structure pour décrire chaque connexion prise en charge par l’objet VPE. Le pilote doit également retourner le nombre de connexions prises en charge dans dwNumEntries. Notez que le pilote est garanti que la mémoire tampon vers laquelle lpConnect pointe est suffisamment grande pour contenir les informations de connexion demandées.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Desktop (Expérience utilisateur) |
| En-tête | ddrawint.h (incluez Winddi.h) |