summaryrefslogtreecommitdiff
path: root/biometrics/adapters/engine_adapter/EngineAdapter.h
blob: 1be2cd6d273a0299167fc9b83607d7098b78fcde (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
/*++
 
    THIS CODE AND INFORMATION IS PROVIDED "AS IS" WITHOUT WARRANTY OF
    ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO
    THE IMPLIED WARRANTIES OF MERCHANTABILITY AND/OR FITNESS FOR A
    PARTICULAR PURPOSE.

    Copyright (c) Microsoft Corporation. All rights reserved

Module Name:

    EngineAdapter.h

Abstract:

    This module contains a stub implementation of an Engine Adapter
    plug-in for the Windows Biometric service.

Author:

    -

Environment:

    Win32, user mode only.

Revision History:

NOTES:

    (None)

--*/
#pragma once

#include "winbio_adapter.h"

///////////////////////////////////////////////////////////////////////////////
//
// The WINIBIO_ENGINE_CONTEXT structure is privately-defined by each
// Engine Adapter. Its purpose is to maintain any information that
// should persist across Engine Adapter API calls. 
//
// The Adapter allocates and initializes one of these structures in its
// 'Attach' routine and saves its address in the Pipeline->EngineContext 
// field.
//
// The Engine Adapter's 'Detach' routine cleans up and deallocates the
// structure and sets the PipelineContext->EngineContext field to NULL.
//
///////////////////////////////////////////////////////////////////////////////
typedef struct _WINIBIO_ENGINE_CONTEXT {
    //
    // The following fields illustrate the kind of information 
    // the Engine Adapter needs to keep in this structure:
    //
    //      FeatureSet      - A processed description of a biometric
    //                        sample.
    //
    //      Enrollment      - An object that tracks the current state
    //                        of an in-progress enrollment operation.
    //
    //      Template        - A template either created from the Feature
    //                        Set or from the Enrollment object.
    //
    //      Comparison      - An object that tracks the result of a
    //                        one-to-one comparison between the Template
    //                        and the Feature Set.
    //
    PVOID x;
    PVOID y;
    PVOID z;

} WINIBIO_ENGINE_CONTEXT, *PWINIBIO_ENGINE_CONTEXT;