Función DirectDrawCreateClipper (ddraw.h)

Crea una instancia de un objeto DirectDrawClipper que no está asociado a un objeto DirectDraw.

Sintaxis

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

Parámetros

[in] dwFlags

Actualmente no se usa y debe establecerse en 0.

[out] lplpDDClipper

Dirección de un puntero que se va a rellenar con la dirección del nuevo objeto DirectDrawClipper.

[in] pUnkOuter

Permite la compatibilidad futura con las características de agregación COM. Actualmente, esta función devuelve un error si este parámetro no es NULL.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto se DD_OK.

Si se produce un error, la función puede devolver uno de los siguientes valores de error:

• DDERR_INVALIDPARAMS
• DDERR_OUTOFMEMORY

Comentarios

Puede llamar a DirectDrawCreateClipper antes de crear cualquier objeto de DirectDraw. Dado que estos objetos DirectDrawClipper no son propiedad de ningún objeto de DirectDraw, no se liberan automáticamente cuando se liberan los objetos de una aplicación. Si la aplicación no libera explícitamente los objetos DirectDrawClipper, DirectDraw los libera cuando finaliza la aplicación.

Para crear un objeto DirectDrawClipper que sea propiedad de un objeto DirectDraw específico, use el método IDirectDraw7::CreateClipper .

Debe usar LoadLibrary para vincular explícitamente a Ddraw.dll y, a continuación, usar GetProcAddress para acceder a la función DirectDrawCreateClipper .

Requisitos