cairo-pdf-surface-create (filename width-in-points height-in-points)

filename -- a string with a filename for the PDF output (must be writable), nil may be used to specify no output, this will generate a PDF surface that may be queried and used as a source, without generating a temporary file
width-in-points -- a double float with the width of the surface, in points (1 point == 1/72.0 inch)
height-in-points -- a double float with the height of the surface, in points (1 point == 1/72.0 inch)

A pointer to the newly created surface. The caller owns the surface and should call the function cairo-surface-destroy when done with it.

This function always returns a valid pointer, but it will return a pointer to a "nil" surface if an error such as out of memory occurs. You can use the function cairo-surface-status to check for this.

Creates a PDF surface of the specified size in points to be written to filename.