RMERROR.C
上传用户:bangxh
上传日期:2007-01-31
资源大小:42235k
文件大小:16k
源码类别:

Windows编程

开发平台:

Visual C++

  1. /*
  2.  *  Copyright (C) 1995, 1996 Microsoft Corporation. All Rights Reserved.
  3.  *
  4.  *  File: rmerror.cpp
  5.  *
  6.  *  Error reporting code for D3DRM examples.
  7.  *
  8.  */
  9. #include "rmerror.h"
  10. #include <stdarg.h>
  11. /* Msg
  12.  * Displays a message box containing the given formatted string.
  13.  */
  14. void __cdecl
  15. Msg( LPSTR fmt, ... )
  16. {
  17.     char buff[256];
  18.     va_list args;
  19.     
  20.     va_start(args, fmt);
  21.     wvsprintf(buff, fmt, args);
  22.     va_end(args);
  23.     
  24.     lstrcat(buff, "rn");
  25.     MessageBox( NULL, buff, "D3DRM Example Message", MB_OK );
  26. }
  27. /*
  28.  * D3DRMErrorToString
  29.  * Returns a pointer to a string describing the given DD, D3D or D3DRM error code.
  30.  */
  31. char*
  32. D3DRMErrorToString(HRESULT error)
  33. {
  34.     switch(error) {
  35.         case DD_OK:
  36.     /* Also includes D3D_OK and D3DRM_OK */
  37.             return "No error.";
  38.         case DDERR_ALREADYINITIALIZED:
  39.             return "This object is already initialized.";
  40.         case DDERR_BLTFASTCANTCLIP:
  41.             return "Return if a clipper object is attached to the source surface passed into a BltFast call.";
  42.         case DDERR_CANNOTATTACHSURFACE:
  43.             return "This surface can not be attached to the requested surface.";
  44.         case DDERR_CANNOTDETACHSURFACE:
  45.             return "This surface can not be detached from the requested surface.";
  46.         case DDERR_CANTCREATEDC:
  47.             return "Windows can not create any more DCs.";
  48.         case DDERR_CANTDUPLICATE:
  49.             return "Can't duplicate primary & 3D surfaces, or surfaces that are implicitly created.";
  50.         case DDERR_CLIPPERISUSINGHWND:
  51.             return "An attempt was made to set a cliplist for a clipper object that is already monitoring an hwnd.";
  52.         case DDERR_COLORKEYNOTSET:
  53.             return "No src color key specified for this operation.";
  54.         case DDERR_CURRENTLYNOTAVAIL:
  55.             return "Support is currently not available.";
  56.         case DDERR_DIRECTDRAWALREADYCREATED:
  57.             return "A DirectDraw object representing this driver has already been created for this process.";
  58.         case DDERR_EXCEPTION:
  59.             return "An exception was encountered while performing the requested operation.";
  60.         case DDERR_EXCLUSIVEMODEALREADYSET:
  61.             return "An attempt was made to set the cooperative level when it was already set to exclusive.";
  62.         case DDERR_GENERIC:
  63.             return "Generic failure.";
  64.         case DDERR_HEIGHTALIGN:
  65.             return "Height of rectangle provided is not a multiple of reqd alignment.";
  66.         case DDERR_HWNDALREADYSET:
  67.             return "The CooperativeLevel HWND has already been set. It can not be reset while the process has surfaces or palettes created.";
  68.         case DDERR_HWNDSUBCLASSED:
  69.             return "HWND used by DirectDraw CooperativeLevel has been subclassed, this prevents DirectDraw from restoring state.";
  70.         case DDERR_IMPLICITLYCREATED:
  71.             return "This surface can not be restored because it is an implicitly created surface.";
  72.         case DDERR_INCOMPATIBLEPRIMARY:
  73.             return "Unable to match primary surface creation request with existing primary surface.";
  74.         case DDERR_INVALIDCAPS:
  75.             return "One or more of the caps bits passed to the callback are incorrect.";
  76.         case DDERR_INVALIDCLIPLIST:
  77.             return "DirectDraw does not support the provided cliplist.";
  78.         case DDERR_INVALIDDIRECTDRAWGUID:
  79.             return "The GUID passed to DirectDrawCreate is not a valid DirectDraw driver identifier.";
  80.         case DDERR_INVALIDMODE:
  81.             return "DirectDraw does not support the requested mode.";
  82.         case DDERR_INVALIDOBJECT:
  83.             return "DirectDraw received a pointer that was an invalid DIRECTDRAW object.";
  84.         case DDERR_INVALIDPARAMS:
  85.             return "One or more of the parameters passed to the function are incorrect.";
  86.         case DDERR_INVALIDPIXELFORMAT:
  87.             return "The pixel format was invalid as specified.";
  88.         case DDERR_INVALIDPOSITION:
  89.             return "Returned when the position of the overlay on the destination is no longer legal for that destination.";
  90.         case DDERR_INVALIDRECT:
  91.             return "Rectangle provided was invalid.";
  92.         case DDERR_LOCKEDSURFACES:
  93.             return "Operation could not be carried out because one or more surfaces are locked.";
  94.         case DDERR_NO3D:
  95.             return "There is no 3D present.";
  96.         case DDERR_NOALPHAHW:
  97.             return "Operation could not be carried out because there is no alpha accleration hardware present or available.";
  98.         case DDERR_NOBLTHW:
  99.             return "No blitter hardware present.";
  100.         case DDERR_NOCLIPLIST:
  101.             return "No cliplist available.";
  102.         case DDERR_NOCLIPPERATTACHED:
  103.             return "No clipper object attached to surface object.";
  104.         case DDERR_NOCOLORCONVHW:
  105.             return "Operation could not be carried out because there is no color conversion hardware present or available.";
  106.         case DDERR_NOCOLORKEY:
  107.             return "Surface doesn't currently have a color key";
  108.         case DDERR_NOCOLORKEYHW:
  109.             return "Operation could not be carried out because there is no hardware support of the destination color key.";
  110.         case DDERR_NOCOOPERATIVELEVELSET:
  111.             return "Create function called without DirectDraw object method SetCooperativeLevel being called.";
  112.         case DDERR_NODC:
  113.             return "No DC was ever created for this surface.";
  114.         case DDERR_NODDROPSHW:
  115.             return "No DirectDraw ROP hardware.";
  116.         case DDERR_NODIRECTDRAWHW:
  117.             return "A hardware-only DirectDraw object creation was attempted but the driver did not support any hardware.";
  118.         case DDERR_NOEMULATION:
  119.             return "Software emulation not available.";
  120.         case DDERR_NOEXCLUSIVEMODE:
  121.             return "Operation requires the application to have exclusive mode but the application does not have exclusive mode.";
  122.         case DDERR_NOFLIPHW:
  123.             return "Flipping visible surfaces is not supported.";
  124.         case DDERR_NOGDI:
  125.             return "There is no GDI present.";
  126.         case DDERR_NOHWND:
  127.             return "Clipper notification requires an HWND or no HWND has previously been set as the CooperativeLevel HWND.";
  128.         case DDERR_NOMIRRORHW:
  129.             return "Operation could not be carried out because there is no hardware present or available.";
  130.         case DDERR_NOOVERLAYDEST:
  131.             return "Returned when GetOverlayPosition is called on an overlay that UpdateOverlay has never been called on to establish a destination.";
  132.         case DDERR_NOOVERLAYHW:
  133.             return "Operation could not be carried out because there is no overlay hardware present or available.";
  134.         case DDERR_NOPALETTEATTACHED:
  135.             return "No palette object attached to this surface.";
  136.         case DDERR_NOPALETTEHW:
  137.             return "No hardware support for 16 or 256 color palettes.";
  138.         case DDERR_NORASTEROPHW:
  139.             return "Operation could not be carried out because there is no appropriate raster op hardware present or available.";
  140.         case DDERR_NOROTATIONHW:
  141.             return "Operation could not be carried out because there is no rotation hardware present or available.";
  142.         case DDERR_NOSTRETCHHW:
  143.             return "Operation could not be carried out because there is no hardware support for stretching.";
  144.         case DDERR_NOT4BITCOLOR:
  145.             return "DirectDrawSurface is not in 4 bit color palette and the requested operation requires 4 bit color palette.";
  146.         case DDERR_NOT4BITCOLORINDEX:
  147.             return "DirectDrawSurface is not in 4 bit color index palette and the requested operation requires 4 bit color index palette.";
  148.         case DDERR_NOT8BITCOLOR:
  149.             return "DirectDrawSurface is not in 8 bit color mode and the requested operation requires 8 bit color.";
  150.         case DDERR_NOTAOVERLAYSURFACE:
  151.             return "Returned when an overlay member is called for a non-overlay surface.";
  152.         case DDERR_NOTEXTUREHW:
  153.             return "Operation could not be carried out because there is no texture mapping hardware present or available.";
  154.         case DDERR_NOTFLIPPABLE:
  155.             return "An attempt has been made to flip a surface that is not flippable.";
  156.         case DDERR_NOTFOUND:
  157.             return "Requested item was not found.";
  158.         case DDERR_NOTLOCKED:
  159.             return "Surface was not locked.  An attempt to unlock a surface that was not locked at all, or by this process, has been attempted.";
  160.         case DDERR_NOTPALETTIZED:
  161.             return "The surface being used is not a palette-based surface.";
  162.         case DDERR_NOVSYNCHW:
  163.             return "Operation could not be carried out because there is no hardware support for vertical blank synchronized operations.";
  164.         case DDERR_NOZBUFFERHW:
  165.             return "Operation could not be carried out because there is no hardware support for zbuffer blitting.";
  166.         case DDERR_NOZOVERLAYHW:
  167.             return "Overlay surfaces could not be z layered based on their BltOrder because the hardware does not support z layering of overlays.";
  168.         case DDERR_OUTOFCAPS:
  169.             return "The hardware needed for the requested operation has already been allocated.";
  170.         case DDERR_OUTOFMEMORY:
  171.             return "DirectDraw does not have enough memory to perform the operation.";
  172.         case DDERR_OUTOFVIDEOMEMORY:
  173.             return "DirectDraw does not have enough memory to perform the operation.";
  174.         case DDERR_OVERLAYCANTCLIP:
  175.             return "The hardware does not support clipped overlays.";
  176.         case DDERR_OVERLAYCOLORKEYONLYONEACTIVE:
  177.             return "Can only have ony color key active at one time for overlays.";
  178.         case DDERR_OVERLAYNOTVISIBLE:
  179.             return "Returned when GetOverlayPosition is called on a hidden overlay.";
  180.         case DDERR_PALETTEBUSY:
  181.             return "Access to this palette is being refused because the palette is already locked by another thread.";
  182.         case DDERR_PRIMARYSURFACEALREADYEXISTS:
  183.             return "This process already has created a primary surface.";
  184.         case DDERR_REGIONTOOSMALL:
  185.             return "Region passed to Clipper::GetClipList is too small.";
  186.         case DDERR_SURFACEALREADYATTACHED:
  187.             return "This surface is already attached to the surface it is being attached to.";
  188.         case DDERR_SURFACEALREADYDEPENDENT:
  189.             return "This surface is already a dependency of the surface it is being made a dependency of.";
  190.         case DDERR_SURFACEBUSY:
  191.             return "Access to this surface is being refused because the surface is already locked by another thread.";
  192.         case DDERR_SURFACEISOBSCURED:
  193.             return "Access to surface refused because the surface is obscured.";
  194.         case DDERR_SURFACELOST:
  195.             return "Access to this surface is being refused because the surface memory is gone. The DirectDrawSurface object representing this surface should have Restore called on it.";
  196.         case DDERR_SURFACENOTATTACHED:
  197.             return "The requested surface is not attached.";
  198.         case DDERR_TOOBIGHEIGHT:
  199.             return "Height requested by DirectDraw is too large.";
  200.         case DDERR_TOOBIGSIZE:
  201.             return "Size requested by DirectDraw is too large, but the individual height and width are OK.";
  202.         case DDERR_TOOBIGWIDTH:
  203.             return "Width requested by DirectDraw is too large.";
  204.         case DDERR_UNSUPPORTED:
  205.             return "Action not supported.";
  206.         case DDERR_UNSUPPORTEDFORMAT:
  207.             return "FOURCC format requested is unsupported by DirectDraw.";
  208.         case DDERR_UNSUPPORTEDMASK:
  209.             return "Bitmask in the pixel format requested is unsupported by DirectDraw.";
  210.         case DDERR_VERTICALBLANKINPROGRESS:
  211.             return "Vertical blank is in progress.";
  212.         case DDERR_WASSTILLDRAWING:
  213.             return "Informs DirectDraw that the previous Blt which is transfering information to or from this Surface is incomplete.";
  214.         case DDERR_WRONGMODE:
  215.             return "This surface can not be restored because it was created in a different mode.";
  216.         case DDERR_XALIGN:
  217.             return "Rectangle provided was not horizontally aligned on required boundary.";
  218.         case D3DERR_BADMAJORVERSION:
  219.             return "D3DERR_BADMAJORVERSION";
  220.         case D3DERR_BADMINORVERSION:
  221.             return "D3DERR_BADMINORVERSION";
  222.         case D3DERR_EXECUTE_LOCKED:
  223.             return "D3DERR_EXECUTE_LOCKED";
  224.         case D3DERR_EXECUTE_NOT_LOCKED:
  225.             return "D3DERR_EXECUTE_NOT_LOCKED";
  226.         case D3DERR_EXECUTE_CREATE_FAILED:
  227.             return "D3DERR_EXECUTE_CREATE_FAILED";
  228.         case D3DERR_EXECUTE_DESTROY_FAILED:
  229.             return "D3DERR_EXECUTE_DESTROY_FAILED";
  230.         case D3DERR_EXECUTE_LOCK_FAILED:
  231.             return "D3DERR_EXECUTE_LOCK_FAILED";
  232.         case D3DERR_EXECUTE_UNLOCK_FAILED:
  233.             return "D3DERR_EXECUTE_UNLOCK_FAILED";
  234.         case D3DERR_EXECUTE_FAILED:
  235.             return "D3DERR_EXECUTE_FAILED";
  236.         case D3DERR_EXECUTE_CLIPPED_FAILED:
  237.             return "D3DERR_EXECUTE_CLIPPED_FAILED";
  238.         case D3DERR_TEXTURE_NO_SUPPORT:
  239.             return "D3DERR_TEXTURE_NO_SUPPORT";
  240.         case D3DERR_TEXTURE_NOT_LOCKED:
  241.             return "D3DERR_TEXTURE_NOT_LOCKED";
  242.         case D3DERR_TEXTURE_LOCKED:
  243.             return "D3DERR_TEXTURELOCKED";
  244.         case D3DERR_TEXTURE_CREATE_FAILED:
  245.             return "D3DERR_TEXTURE_CREATE_FAILED";
  246.         case D3DERR_TEXTURE_DESTROY_FAILED:
  247.             return "D3DERR_TEXTURE_DESTROY_FAILED";
  248.         case D3DERR_TEXTURE_LOCK_FAILED:
  249.             return "D3DERR_TEXTURE_LOCK_FAILED";
  250.         case D3DERR_TEXTURE_UNLOCK_FAILED:
  251.             return "D3DERR_TEXTURE_UNLOCK_FAILED";
  252.         case D3DERR_TEXTURE_LOAD_FAILED:
  253.             return "D3DERR_TEXTURE_LOAD_FAILED";
  254.         case D3DERR_MATRIX_CREATE_FAILED:
  255.             return "D3DERR_MATRIX_CREATE_FAILED";
  256.         case D3DERR_MATRIX_DESTROY_FAILED:
  257.             return "D3DERR_MATRIX_DESTROY_FAILED";
  258.         case D3DERR_MATRIX_SETDATA_FAILED:
  259.             return "D3DERR_MATRIX_SETDATA_FAILED";
  260.         case D3DERR_SETVIEWPORTDATA_FAILED:
  261.             return "D3DERR_SETVIEWPORTDATA_FAILED";
  262.         case D3DERR_MATERIAL_CREATE_FAILED:
  263.             return "D3DERR_MATERIAL_CREATE_FAILED";
  264.         case D3DERR_MATERIAL_DESTROY_FAILED:
  265.             return "D3DERR_MATERIAL_DESTROY_FAILED";
  266.         case D3DERR_MATERIAL_SETDATA_FAILED:
  267.             return "D3DERR_MATERIAL_SETDATA_FAILED";
  268.         case D3DERR_LIGHT_SET_FAILED:
  269.             return "D3DERR_LIGHT_SET_FAILED";
  270. case D3DRMERR_BADOBJECT:
  271.     return "D3DRMERR_BADOBJECT";
  272. case D3DRMERR_BADTYPE:
  273.     return "D3DRMERR_BADTYPE";
  274. case D3DRMERR_BADALLOC:
  275.     return "D3DRMERR_BADALLOC";
  276. case D3DRMERR_FACEUSED:
  277.     return "D3DRMERR_FACEUSED";
  278. case D3DRMERR_NOTFOUND:
  279.     return "D3DRMERR_NOTFOUND";
  280. case D3DRMERR_NOTDONEYET:
  281.     return "D3DRMERR_NOTDONEYET";
  282. case D3DRMERR_FILENOTFOUND:
  283.     return "The file was not found.";
  284. case D3DRMERR_BADFILE:
  285.     return "D3DRMERR_BADFILE";
  286. case D3DRMERR_BADDEVICE:
  287.     return "D3DRMERR_BADDEVICE";
  288. case D3DRMERR_BADVALUE:
  289.     return "D3DRMERR_BADVALUE";
  290. case D3DRMERR_BADMAJORVERSION:
  291.     return "D3DRMERR_BADMAJORVERSION";
  292. case D3DRMERR_BADMINORVERSION:
  293.     return "D3DRMERR_BADMINORVERSION";
  294. case D3DRMERR_UNABLETOEXECUTE:
  295.     return "D3DRMERR_UNABLETOEXECUTE";
  296.         default:
  297.             return "Unrecognized error value.";
  298.     }
  299. }