Funzione ICDrawBegin (vfw.h)
La funzione ICDrawBegin inizializza il renderer e prepara la destinazione di disegno per il disegno.
Sintassi
DWORD VFWAPIV ICDrawBegin(
HIC hic,
DWORD dwFlags,
HPALETTE hpal,
HWND hwnd,
HDC hdc,
int xDst,
int yDst,
int dxDst,
int dyDst,
LPBITMAPINFOHEADER lpbi,
int xSrc,
int ySrc,
int dxSrc,
int dySrc,
DWORD dwRate,
DWORD dwScale
);
Parametri
hic
Gestire il decompressore da usare.
dwFlags
Flag di decompressione. I valori seguenti sono definiti.
| Valore | Significato |
|---|---|
| ICDRAW_ANIMATE | L'applicazione può animare la tavolozza. |
| ICDRAW_CONTINUE | Il disegno è una continuazione della cornice precedente. |
| ICDRAW_FULLSCREEN | Disegna i dati decompressi sullo schermo intero. |
| ICDRAW_HDC | Disegna i dati decompressi in una finestra o in un controller di dominio. |
| ICDRAW_MEMORYDC | DC è fuori schermo. |
| ICDRAW_QUERY | Determina se il decompressore può decomprimere i dati. Il driver non decompresse i dati. |
| ICDRAW_UPDATING | Il frame corrente viene aggiornato anziché riprodotto. |
hpal
Handle nella tavolozza utilizzata per il disegno.
hwnd
Handle nella finestra usata per il disegno.
hdc
DC usato per il disegno.
xDst
Coordinata x dell'angolo superiore destro del rettangolo di destinazione.
yDst
Coordinata y dell'angolo superiore destro del rettangolo di destinazione.
dxDst
Larghezza del rettangolo di destinazione.
dyDst
Altezza del rettangolo di destinazione.
lpbi
Puntatore a una struttura BITMAPINFOHEADER contenente il formato dei dati di input da decomprimere.
xSrc
Coordinata x dell'angolo superiore destro del rettangolo di origine.
ySrc
Coordinata y dell'angolo superiore destro del rettangolo di origine.
dxSrc
Larghezza del rettangolo di origine.
dySrc
Altezza del rettangolo di origine.
dwRate
Numeratore della frequenza dei fotogrammi. La frequenza dei fotogrammi, in fotogrammi al secondo, viene ottenuta suddividendo dwRate da dwScale.
dwScale
Denominatore della frequenza dei fotogrammi. La frequenza dei fotogrammi, in fotogrammi al secondo, viene ottenuta suddividendo dwRate da dwScale.
Valore restituito
Restituisce ICERR_OK se il renderer può decomprimere i dati o ICERR_UNSUPPORTED in caso contrario.
Commenti
I flag ICDRAW_HDC e ICDRAW_FULLSCREEN si escludono a vicenda. Se un'applicazione imposta il flag di ICDRAW_HDC in dwFlags, il decompressore usa hwnd, hdc e i parametri che definiscono il rettangolo di destinazione (xDst, yDst, dxDst e dyDst). L'applicazione deve impostare questi parametri sulle dimensioni del rettangolo di destinazione. Specificare i valori del rettangolo di destinazione relativi alla finestra corrente o al controller di dominio corrente.
Se un'applicazione imposta il flag ICDRAW_FULLSCREEN in dwFlags, i parametri hwnd e hdc non vengono usati e devono essere impostati su NULL. Inoltre, il rettangolo di destinazione non viene usato e i relativi parametri possono essere impostati su zero.
Il rettangolo di origine è relativo al fotogramma video completo. La parte del fotogramma video specificato dal rettangolo di origine è estesa o ridimensionata per adattare il rettangolo di destinazione.
I parametri dwRate e dwScale specificano la frequenza di decompressione. Il valore integer specificato per dwRate diviso per il valore intero specificato per dwScale definisce la frequenza dei fotogrammi nei fotogrammi al secondo. Questo valore viene usato dal renderer quando è responsabile dei fotogrammi di intervallo durante la riproduzione.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 2000 Professional [solo app desktop] |
| Server minimo supportato | Windows 2000 Server [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | vfw.h |
| Libreria | Vfw32.lib |
| DLL | Msvfw32.dll |