PDD_VPORTCB_GETINPUTFORMATS fonction de rappel (ddrawint.h)

Article
08/23/2023

La fonction de rappel DdVideoPortGetInputFormats détermine les formats d’entrée que l’objet DIRECTDraw VPE peut accepter.

Syntaxe

PDD_VPORTCB_GETINPUTFORMATS PddVportcbGetinputformats;

DWORD PddVportcbGetinputformats(
  PDD_GETVPORTINPUTFORMATDATA unnamedParam1
)
{...}

Paramètres

unnamedParam1

Pointe vers une structure DD_GETVPORTINPUTFORMATDATA qui contient les informations requises pour que le pilote retourne les formats d’entrée que l’objet VPE peut accepter.

Valeur retournée

DdVideoPortGetInputFormats retourne l’un des codes de rappel suivants :

Notes

DdVideoPortGetInputFormats doit être implémenté dans les pilotes DirectDraw qui prennent en charge VPE.

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

Dans le premier appel, le membre lpddpfFormat de la structure DD_GETVPORTINPUTFORMATDATA à lpGetInputFormats est NULL. Le pilote doit écrire le nombre de formats d’entrée pris en charge par l’objet VPE dans le membre dwNumFormats de DD_GETVPORTINPUTFORMATDATA. Au retour, DirectDraw alloue ce nombre de structures DDPIXELFORMAT pour passer le deuxième appel à DdVideoPortGetInputFormats.
Dans le deuxième appel, lpddpfFormat pointe vers le tableau des structures DDPIXELFORMAT allouées. Le pilote doit remplir chaque structure pour décrire chaque format d’entrée pris en charge par l’objet VPE. Le pilote doit également retourner le nombre de formats d’entrée pris en charge dans dwNumFormats. Notez que le pilote est garanti que la mémoire tampon vers laquelle lpddpfFormat pointe est suffisamment grande pour contenir les informations de format demandées.

Si le membre dwFlags de la structure DD_GETVPORTINPUTFORMATDATA est défini uniquement sur DDVPFORMAT_VIDEO, le pilote doit retourner uniquement les formats 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 (incluez Winddi.h)

Voir aussi

DDPIXELFORMAT

DD_GETVPORTINPUTFORMATDATA

Partager via