PDD_VPORTCB_GETOUTPUTFORMATS fonction de rappel (ddrawint.h)

Article
08/23/2023

La fonction de rappel DdVideoPortGetOutputFormats détermine les formats de sortie pris en charge par l’objet VPE.

Syntaxe

PDD_VPORTCB_GETOUTPUTFORMATS PddVportcbGetoutputformats;

DWORD PddVportcbGetoutputformats(
  PDD_GETVPORTOUTPUTFORMATDATA unnamedParam1
)
{...}

Paramètres

unnamedParam1

Pointe vers une structure de DD_GETVPORTOUTPUTFORMATDATA qui contient les informations requises pour que le pilote retourne les formats de sortie pris en charge par l’objet VPE.

Valeur retournée

DdVideoPortGetOutputFormats retourne l’un des codes de rappel suivants :

Notes

Les pilotes DirectDraw qui prennent en charge VPE doivent implémenter DdVideoPortGetOutputFormats

DirectDraw appelle DdVideoPortGetOutputFormats pour obtenir le nombre de formats de sortie pris en charge par l’objet VPE spécifié et une description de chaque format. DdVideoPortGetOutputFormats est appelé deux fois pour l’objet VPE spécifié :

Dans le premier appel, le membre lpddpfOutputFormats de la structure DD_GETVPORTOUTPUTFORMATDATA à lpGetOutputFormats a la valeur NULL. Le pilote doit écrire le nombre de formats de sortie pris en charge par l’objet VPE dans le membre dwNumFormats de DD_GETVPORTOUTPUTFORMATDATA. Au retour, DirectDraw allouera ce nombre de structures DDPIXELFORMAT pour passer le deuxième appel à DdVideoPortGetOutputFormats.
Dans le deuxième appel, lpddpfOutputFormats pointe vers le tableau des structures DDPIXELFORMAT allouées. Le pilote doit remplir chaque structure avec une description de chaque format de sortie que l’objet VPE peut écrire dans la mémoire tampon de trame. Le pilote doit retourner uniquement les formats de sortie qu’il prend en charge en fonction du format d’entrée des données vidéo. Le pilote doit également retourner le nombre de formats de sortie pris en charge dans dwNumFormats. Notez que le pilote est garanti que la mémoire tampon vers laquelle pointe lpddpfOutputFormats est suffisamment grande pour contenir les informations de format demandées.

Si le membre dwFlags de DD_GETVPORTOUTPUTFORMATDATA est défini uniquement sur DDVPFORMAT_VIDEO, le pilote doit retourner uniquement les formats de sortie pris en charge pour les données vidéo normales. Si dwFlags est défini uniquement sur DDVPFORMAT_VBI, le pilote doit retourner uniquement les formats pris en charge pour les données VBI . Si dwFlags est défini sur les deux indicateurs, le pilote doit retourner tous les formats pris en charge par l’objet VPE .

Spécifications


Plateforme cible	Desktop (Expérience utilisateur)
En-tête	ddrawint.h (inclure Winddi.h)

Voir aussi

DDPIXELFORMAT

DD_GETVPORTOUTPUTFORMATDATA

Partager via