建置擴充單元範例控制項

發行項
06/15/2023

重要

本主題中的內容和範例程式碼已過期，目前不支援。它可能無法與目前的驅動程式開發工具鏈搭配使用。

您可以編譯本節中的程式碼，以建立 UVC 擴充單元範例控制項。當您建置此專案時，您可以建立 Microsoft ActiveX 控制項，以便與對應的應用程式搭配使用，以取得和設定擴充單元上的屬性。

若要使用控制項，您需要實作特定擴充單元功能的硬體。或者，您可以使用 USB 模擬器。

使用下列步驟來建置控制項：

安裝下列套件：
- Microsoft Windows Server 2003 service Pack 1 (SP1) Driver Development Kit (DDK)
- Microsoft DirectX 9.0 SDK Update (2005 年 2 月)
- Microsoft DirectX 9.0 2005 年 2 月 SDK 額外專案
將下列主題中的範例程式碼複製到個別檔案中。

UVC 擴充單位的範例介面

範例擴充單元外掛程式 DLL

UVC 擴充單元的範例登錄專案

UVC 擴充單元的範例應用程式

支援具有擴充單位的自動更新事件

提供 UVC INF 檔案

建立來源檔案，如下所示：

TARGETNAME= uvcxuplgn
TARGETTYPE= DYNLINK
TARGETPATH= obj
TARGETEXT=  ax

DLLENTRY=_DllMainCRTStartup
DLLBASE=0x10080000
USE_MSVCRT=1

USE_STATIC_ATL=1

USER_INCLUDES= $(O)

INCLUDES=

SOURCES= interface.idl \
 uvcxuplgn.cpp \
         stdafx.cpp    \
         interface_i.c \
         vidcap_i.c    \
         xuproxy.cpp

TARGETLIBS= \
        $(SDK_LIB_PATH)\kernel32.lib          \
        $(SDK_LIB_PATH)\user32.lib            \
        $(SDK_LIB_PATH)\gdi32.lib             \
        $(SDK_LIB_PATH)\advapi32.lib          \
        $(SDK_LIB_PATH)\comdlg32.lib          \
        $(SDK_LIB_PATH)\ole32.lib             \
        $(SDK_LIB_PATH)\oleaut32.lib          \
        $(SDK_LIB_PATH)\uuid.lib              \
        $(SDK_LIB_PATH)\comctl32.lib

建立 makefile 檔案，如下所示：

#############################################################################
#
#       Copyright (C) Microsoft Corporation 1995
#       All Rights Reserved.
#
#       MAKEFILE for WDM device driver kit
#
#############################################################################

#
# DO NOT EDIT THIS FILE!!!  Edit .\sources. if you want to add a new source
# file to this component.  This file merely indirects to the real make file
# that is shared by all the driver components of the Windows NT DDK
#

!if "$(WIN2K_DDKBUILD)" == ""
!INCLUDE $(NTMAKEENV)\makefile.def
!endif

使用包含在Microsoft Windows SDK) 中的Guidgen.exe工具 (來建立三個 GUID：
- 使用第一個 GUID 作為擴充單元的屬性集識別碼。將 x 型 GUID 預留位置取代為 Xuproxy.h、Xusample.rgs、Xuplgin.inf 中的新 GUID，以及硬體層級的擴充單元描述元。
- 使用第二個 GUID 作為擴充單位的 IID。將以 y 為基礎的 GUID 預留位置取代為 Interface.idl 和 Xuplgin.inf中的新 GUID。
- 使用第三個 GUID 作為擴充單元的類別 GUID (clsid) 。將 z 型 GUID 預留位置取代為Xuplgin.inf、Xuproxy.h和Xusample.rgs中的新 GUID。

建立 Uvcxuplgn.def ，如下所示：

LIBRARY uvcxuplgn

EXPORTS
    DllGetClassObject   PRIVATE
    DllCanUnloadNow     PRIVATE
    DllRegisterServer   PRIVATE
    DllUnregisterServer PRIVATE

建立 Uvcxuplgn.cpp ，如下所示：

#include "stdafx.h"
CComModule _Module;
#include <initguid.h>
#include "interface.h"
#include "xuproxy.h"
BEGIN_OBJECT_MAP(ObjectMap)
OBJECT_ENTRY(CLSID_ExtensionUnit, CExtension)
END_OBJECT_MAP()

STDAPI DllRegisterServer(void)
{
    return _Module.RegisterServer(FALSE, NULL);
}

STDAPI DllUnregisterServer(void)
{
    return _Module.UnregisterServer();
}

EXTERN_C
BOOL
DllMain(
    HINSTANCE   hinst,
    DWORD       dwReason,
    LPVOID      lpReserved)
{
    switch (dwReason) {
        case DLL_PROCESS_ATTACH:

            _Module.Init (ObjectMap, hinst);
            break;

        case DLL_PROCESS_DETACH:
            _Module.Term();
            break;
    }
    return TRUE;
}

extern "C" STDMETHODIMP DllCanUnloadNow(void)
{
    return _Module.GetLockCount()==0 ? S_OK : S_FALSE;
}

extern "C" STDAPI DllGetClassObject(
    REFCLSID    rclsid,
    REFIID      riid,
    LPVOID      *ppv)
{
    return _Module.GetClassObject(rclsid, riid, ppv);
}

建立 Stdafx.h ，如下所示：

// stdafx.h : include file for standard system include files,
//      or project specific include files that are used frequently,
//      but are changed infrequently

#if !defined(AFX_STDAFX_H__722DC775_FE6F_42FB_BED5_E1E299976D17__INCLUDED_)
#define AFX_STDAFX_H__722DC775_FE6F_42FB_BED5_E1E299976D17__INCLUDED_

#if _MSC_VER > 1000
#pragma once
#endif // _MSC_VER > 1000

#define STRICT
#ifndef _WIN32_WINNT
#define _WIN32_WINNT 0x0400
#endif
#define _ATL_APARTMENT_THREADED

#include <atlbase.h>
//You may derive a class from CComModule and use it if you want to override
//something, but do not change the name of _Module
extern CComModule _Module;
#include <atlcom.h>
#include <atlctl.h>

//{{AFX_INSERT_LOCATION}}
// Microsoft Visual C++ will insert additional declarations immediately before the previous line.

#endif // !defined(AFX_STDAFX_H__722DC775_FE6F_42FB_BED5_E1E299976D17__INCLUDED)

建立 Stdafx.cpp ，如下所示：

// stdafx.cpp : source file that includes just the standard includes
//  stdafx.pch will be the pre-compiled header
//  stdafx.obj will contain the pre-compiled type information

#include "stdafx.h"

#ifdef _ATL_STATIC_REGISTRY
#include <statreg.h>
#include <statreg.cpp>
#endif

#include <atlimpl.cpp>

在 WDK 建置環境中叫用 Build -cZg 來建置範例。

另請參閱

共用方式為

建置擴充單元範例控制項

另請參閱

意見反應

其他資源