PDD_VPORTCB_GETOUTPUTFORMATS funzione di callback (ddrawint.h)

Articolo
08/23/2023

La funzione di callback DdVideoPortGetOutputFormats determina i formati di output supportati dall'oggetto VPE.

Sintassi

PDD_VPORTCB_GETOUTPUTFORMATS PddVportcbGetoutputformats;

DWORD PddVportcbGetoutputformats(
  PDD_GETVPORTOUTPUTFORMATDATA unnamedParam1
)
{...}

Parametri

unnamedParam1

Punta a una struttura DD_GETVPORTOUTPUTFORMATDATA che contiene le informazioni necessarie per il driver per restituire i formati di output supportati dall'oggetto VPE.

Valore restituito

DdVideoPortGetOutputFormats restituisce uno dei codici di callback seguenti:

Commenti

I driver DirectDraw che supportano VPE devono implementare DdVideoPortGetOutputFormats

DirectDraw chiama DdVideoPortGetOutputFormats per ottenere il numero di formati di output supportati dall'oggetto VPE specificato e una descrizione di ogni formato. DdVideoPortGetOutputFormats viene chiamato due volte per l'oggetto VPE specificato:

Nella prima chiamata, il membro lpddpfOutputFormats della struttura DD_GETVPORTOUTPUTFORMATDATA in lpGetOutputFormats è NULL. Il driver deve scrivere il numero di formati di output supportati dall'oggetto VPE nel membro dwNumFormats di DD_GETVPORTOUTPUTFORMATDATA. Al termine della restituzione, DirectDraw allocherà questo numero di strutture DDPIXELFORMAT da passare alla seconda chiamata a DdVideoPortGetOutputFormats.
Nella seconda chiamata lpddpfOutputFormats punta alla matrice di strutture DDPIXELFORMAT allocate. Il driver deve compilare ogni struttura con una descrizione di ogni formato di output che l'oggetto VPE può scrivere nel buffer dei fotogrammi. Il driver deve restituire solo i formati di output supportati in base al formato di input dei dati video. Il driver deve restituire anche il numero di formati di output supportati in dwNumFormats. Si noti che il driver garantisce che il buffer in cui i punti lpddpfOutputFormats sia sufficientemente grande da contenere le informazioni sul formato richieste.

Se il membro dwFlags di DD_GETVPORTOUTPUTFORMATDATA è impostato solo su DDVPFORMAT_VIDEO, il driver deve restituire solo i formati di output supportati per i normali dati video. Se dwFlags è impostato solo su DDVPFORMAT_VBI, il driver deve restituire solo i formati supportati per i dati VBI . Se dwFlags è impostato su entrambi i flag, il driver deve restituire tutti i formati supportati dall'oggetto VPE .

Requisiti


Piattaforma di destinazione	Desktop
Intestazione	ddrawint.h (include Winddi.h)

Vedi anche

DDPIXELFORMAT

DD_GETVPORTOUTPUTFORMATDATA

Share via