DirectX程序通用框架

下面只是一个DirectX程序框架，并没有什么实际上的Direct3D的代码，因此自定义函数基本上还是空的。

//【程序说明】
//程序名称：D3DdemoCore
//描述：Direct3D程序的核心框架
//

//【头文件包含部分】
//描述：包含程序所依赖的头文件
//
#include <d3d9.h>

//【库文件包含部分】
//描述：包含程序所依赖的库文件
//
#pragma comment(lib,"winmm.lib")//调用PlaySound函数所需库文件

//【宏定义部分】
//描述：定义一些辅助宏
//
#define WINDOW_WIDTH 800 //为窗口宽度定义的宏，以方便在此修改窗口宽度
#define WINDOW_HEIGHT 600 //为窗口高度定义的宏，以方便在此修改窗口的高度
#define WINDOW_TITLE L"Direct3D程序的核心框架"//为窗口标题定义的宏
#define SAFE_RELEASE(p) {if(p) { (p)->Release(); (p)=NULL;} }//定义一个安全释放宏，便于后面COM接口指针的释放

//【全局变量声明部分】
//描述：全局变量的声明
//

//【全局函数声明部分】
//描述：全局函数声明，防止“未声明的标识”系列错误
//
LRESULT CALLBACK WndProc(HWND hwnd, UINT message, WPARAM wParam, LPARAM lParam);//窗口过程函数
//LRESULT是窗口函数的返回值，一般情况是非零值
//CALLBACK就是__stdcall，一种调用约定，让编译器知道以windows兼容的方式来产生机器指令
//第一个参数hwnd，就是需要处理消息的那个窗口的句柄
//第二个参数message，表示待处理消息的ID，即消息的类型
//第三、四个参数wParam和lParam，表示消息的附加信息
HRESULT Direct3D_Init(HWND hwnd);//这个函数中进行了DirectX的初始化
//HRESULT是函数执行不同状态返回的结果
HRESULT Object_Init(HWND hwnd);//这个函数中进行要绘制的物体的资源初始化
VOID Direct3D_Render(HWND hwnd);//这个函数中进行Direct3D渲染代码的书写
VOID Direct3D_CleanUp();//这个函数中清理COM资源及其他资源

//【WinMain（）函数】
//描述：Windows应用程序的入口函数，程序从这里开始
int WINAPI WinMain(HINSTANCE hInstance,HINSTANCE hPrevInstance,LPSTR lpCmdLine,int nShowCmd)
	//WINAPI就是__stdcall，一种调用约定，让编译器知道以windows兼容的方式来产生机器指令
	//第一个参数hInstance，表示该程序当前运行的实例句柄。
	//第二个参数hPrevInstance，表示当前实例的前一个实例的句柄。win32中该函数其实没有作用。
	//第三个参数lpCmdLine，就是字符串，指定传递给运行程序的命令行参数。
	//第四个参数nShowCmd，指定窗口应该如何显示。
{
	//【1】窗口创建四部曲之一：开始设计一个完整的窗口类
	WNDCLASSEX wndClass = {0};
	wndClass.cbSize = sizeof(WNDCLASSEX);//设置结构体的字节数大小
	wndClass.style = CS_HREDRAW | CS_VREDRAW;//设置窗口样式
	wndClass.lpfnWndProc = WndProc;//设置指向窗口过程的指针
	wndClass.cbClsExtra = 0;//窗口类的附加内存，取0就可以了
	wndClass.cbWndExtra = 0;//窗口的附加内存，依然取0就可以了
	wndClass.hInstance = hInstance;//指定包含窗口过程的程序的实例句柄
	wndClass.hIcon = (HICON)::LoadImage(NULL,L"icon.ico",IMAGE_ICON,0,0,LR_DEFAULTSIZE|LR_LOADFROMFILE);//本地加载自定义icon图标
	//LoadImage第一个参数hInst，被加载图像模型的实例句柄，若从硬盘文件或资源文件中进行加载，这个参数设为NULL。
	//第二个参数name，被加载的资源所在的路径与文件名或资源名称。
	//第三个参数type，指定被加载的图像的类型
	//第四、五个参数cx与cy，指定光标或图标加载后在内存中储存的宽度与高度，若为0表示用系统预设的值。
	//第六个参数fuLoad，指定位图的加载方式，LR_DEFAULTSIZE表示默认大小，LR_LOADFROMFILE表示从文件加载
	wndClass.hCursor = LoadCursor(NULL, IDC_ARROW);//指定窗口类的光标句柄，这里为默认的系统光标
	wndClass.hbrBackground=(HBRUSH)GetStockObject(GRAY_BRUSH);//GetStockObject函数来得到系统的标准画刷，为hbrBackground成员指定了一个白色画刷句柄
	wndClass.lpszMenuName = NULL;//指定菜单资源的名字
	wndClass.lpszClassName = L"DirectXWindow";//指定窗口类的名字

	//【2】窗口创建四部曲之二：注册窗口类’
	if(!RegisterClassEx(&wndClass))//设计完窗口后，需要对窗口类进行注册，这样才能创建该类型的窗口
		return -1;

	//【3】窗口创建四部曲之三：正式创建窗口
	HWND hwnd = CreateWindow(L"DirectXWindow",WINDOW_TITLE,WS_OVERLAPPEDWINDOW,CW_USEDEFAULT,CW_USEDEFAULT,WINDOW_WIDTH,WINDOW_HEIGHT,
		NULL,NULL,hInstance,NULL);//WS_OVERLAPPEDWINDOW表示创建一个层叠的窗口，具有一个标题栏和一个边框

	Direct3D_Init(hwnd);//Direct3D资源的初始化

	//【4】窗口创建四部曲之四：窗口的移动、显示与更新
	MoveWindow(hwnd,250,80,WINDOW_WIDTH,WINDOW_HEIGHT,true);//true指定了要重绘窗口
	ShowWindow(hwnd,nShowCmd);//调用ShowWindow函数来显示窗口
	UpdateWindow(hwnd);//对窗口进行更新

	PlaySound(L"War3XMainScreen.wav",NULL,SND_FILENAME|SND_ASYNC|SND_LOOP);//循环播放背景音乐
	//第一个参数pszSound，指定了要播放的声音文件。设为NULL的话，就把所有当前播放的声音全部停掉。
	//第二个参数hmod，包含了作为资源的可执行文件的句柄，这里设为NULL
	//第三个参数fdwSound，控制音乐播放的标志。SND_ASYNC,异步播放方式播放，在开始播放后立即返回。SND_LOOP必须与SND_ASYNC一起使用。
		MessageBox(hwnd,L"DirectX窗口创建完成",L"Hello",0);

	//【5】消息循环过程
	MSG msg = {0};//初始化msg
	while(msg.message != WM_QUIT)
	{
		if( PeekMessage(&msg,0,0,0,PM_REMOVE))//查看应用程序消息队列，有消息时将队列中的消息派发出去
	//第一个参数lpMsg，它指向一个消息(MSG)结构体，从线程的消息队列中取出的消息信息保存在该结构体中
	//第二个参数hWnd，表示指定接受属于哪一个窗口的消息，设为NULL表示接受属于调用线程的所有窗口的窗口消息
	//第三、四个参数wMsgFilterMin和wMsgFilterMax设为0表示接受所有消息
	//第五个参数wRemoveMsg,为PM_REMOVE,表示读取某条消息后，这条消息将从消息队列中被移除
		{
			TranslateMessage(&msg);
			DispatchMessage(&msg);
		}
		else
		{
			Direct3D_Render(hwnd);//进行渲染
		}
	}

	//【6】窗口类的注销
	UnregisterClass(L"DirectXWindow",wndClass.hInstance);//程序准备结束，注销窗口类
	return 0;
}

//【WndProc()函数】
//描述：窗口过程函数WndProc，对窗口消息进行处理
LRESULT CALLBACK WndProc(HWND hwnd, UINT message, WPARAM wParam, LPARAM lParam)
{
	switch(message)
	{
	case WM_PAINT:
		Direct3D_Render(hwnd);//调用Direct3D渲染函数
		ValidateRect(hwnd,NULL);//更新客户区的显示
		break;
	case WM_KEYDOWN://若是键盘按下消息
		if(wParam == VK_ESCAPE)//如果被按下的键是ESC
			DestroyWindow(hwnd);//销毁窗口，并发送一条WM_DESTROY
		break;
	case WM_DESTROY://若是窗口销毁消息
		Direct3D_CleanUp();//调用自定义的资源清理函数Game_CleanUp()进行退出前的资源清理
		PostQuitMessage(0);//向系统表明有个线程有终止请求。用来响应WM_DESTROY消息
		break;
	default:
		return DefWindowProc(hwnd,message,wParam,lParam);//调用默认的窗口过程函数
	}
	return 0;
}

//【Direct3D_Init()函数】
//描述：Direct3D初始化函数，进行Direct3D的初始化
HRESULT Direct3D_Init(HWND hwnd)
{
	if(!(S_OK == Object_Init(hwnd)))//调用一次Object_Init，进行渲染资源的初始化
		return E_FAIL;
	return S_OK;
}

//【Object_Init()函数】
//描述：渲染资源初始化函数，在此函数中进行要被渲染的物体的资源的初始化
HRESULT Object_Init(HWND hwnd)
{
	return S_OK;
}

//【Direct3D_Render()函数】
//描述：使用Direct3D进行渲染
void Direct3D_Render(HWND hwnd)
{
	//暂时未空
}

//【Direct_CleanUp()函数】
void Direct3D_CleanUp()
{
	//暂时为空
}