Funzione DirectDrawCreateClipper (ddraw.h)

Articolo
02/28/2024

Crea un'istanza di un oggetto DirectDrawClipper che non è associato a un oggetto DirectDraw.

Sintassi

HRESULT DirectDrawCreateClipper(
  [in]  DWORD               dwFlags,
  [out] LPDIRECTDRAWCLIPPER *lplpDDClipper,
  [in]  IUnknown            *pUnkOuter
);

Parametri

[in] dwFlags

Attualmente non usato e deve essere impostato su 0.

[out] lplpDDClipper

Indirizzo di un puntatore da compilare con l'indirizzo del nuovo oggetto DirectDrawClipper.

[in] pUnkOuter

Consente la compatibilità futura con le funzionalità di aggregazione COM. Attualmente, questa funzione restituisce un errore se questo parametro non è NULL.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è DD_OK.

Se ha esito negativo, la funzione può restituire uno dei valori di errore seguenti:

DDERR_INVALIDPARAMS
DDERR_OUTOFMEMORY

Commenti

È possibile chiamare DirectDrawCreateClipper prima della creazione di qualsiasi oggetto DirectDraw. Poiché questi oggetti DirectDrawClipper non sono di proprietà di alcun oggetto DirectDraw, non vengono rilasciati automaticamente quando vengono rilasciati gli oggetti di un'applicazione. Se l'applicazione non rilascia in modo esplicito gli oggetti DirectDrawClipper, DirectDraw li rilascia al termine dell'applicazione.

Per creare un oggetto DirectDrawClipper di proprietà di un oggetto DirectDraw specifico, usare il metodo IDirectDraw7::CreateClipper .

È necessario usare LoadLibrary per collegare in modo esplicito Ddraw.dll e quindi usare GetProcAddress per accedere alla funzione DirectDrawCreateClipper .

Requisiti

Requisito	Valore
Piattaforma di destinazione	Windows
Intestazione	ddraw.h
Libreria	Ddraw.lib
DLL	Ddraw.dll

Condividi tramite