PDD_VPORTCB_GETINPUTFORMATS funzione di callback (ddrawint.h)

La funzione di callback DdVideoPortGetInputFormats determina i formati di input che l'oggetto VPE DirectDraw può accettare.

Sintassi

PDD_VPORTCB_GETINPUTFORMATS PddVportcbGetinputformats;

DWORD PddVportcbGetinputformats(
  PDD_GETVPORTINPUTFORMATDATA unnamedParam1
)
{...}

Parametri

unnamedParam1

Punta a una struttura DD_GETVPORTINPUTFORMATDATA contenente le informazioni necessarie per il driver per restituire i formati di input che l'oggetto VPE può accettare.

Valore restituito

DdVideoPortGetInputFormats restituisce uno dei codici di callback seguenti:

Commenti

DdVideoPortGetInputFormats deve essere implementato nei driver DirectDraw che supportano VPE.

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

• Nella prima chiamata, il membro lpddpfFormat della struttura DD_GETVPORTINPUTFORMATDATA in lpGetInputFormats è NULL. Il driver deve scrivere il numero di formati di input supportati dall'oggetto VPE nel membro dwNumFormats di DD_GETVPORTINPUTFORMATDATA. Al ritorno, DirectDraw allocherà questo numero di strutture DDPIXELFORMAT per passare la seconda chiamata a DdVideoPortGetInputFormats.
• Nella seconda chiamata lpddpfFormat punta alla matrice di strutture DDPIXELFORMAT allocata. Il driver deve compilare ogni struttura per descrivere ogni formato di input supportato dall'oggetto VPE. Il driver deve restituire anche il numero di formati di input supportati in dwNumFormats. Si noti che il driver è garantito che il buffer a cui i punti lpddpfFormat siano sufficienti per contenere le informazioni di formato richieste.

Se il membro dwFlags della struttura DD_GETVPORTINPUTFORMATDATA è impostato solo su DDVPFORMAT_VIDEO, il driver deve restituire solo i formati supportati per i dati video normali. 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_GETVPORTINPUTFORMATDATA