summaryrefslogtreecommitdiff
path: root/biometrics/adapters/sensor_adapter/SensorAdapter.h
blob: f70c3f515ffd22869c411285c39d492b8674ca25 (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
/*++
 
    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:

    SensorAdapter.h

Abstract:

    This module contains a stub implementation of an Sensor 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_SENSOR_CONTEXT structure is privately-defined by each
// Sensor Adapter. Its purpose is to maintain any information that
// should persist across Sensor Adapter API calls. 
//
// The Adapter allocates and initializes one of these structures in its
// 'Attach' routine and saves its address in the Pipeline->SensorContext 
// field.
//
// The Sensor Adapter's 'Detach' routine cleans up and deallocates the
// structure and sets the PipelineContext->SensorContext field to NULL.
//
///////////////////////////////////////////////////////////////////////////////
typedef struct _WINIBIO_SENSOR_CONTEXT {
    //
    // The following fields illustrate the kind of information 
    // the Sensor Adapter needs to keep in this structure:
    //
    //      SampleBuffer    - A pointer to the most-recently-captured
    //                        data sample from the sensor device.
    //
    //      SampleSize      - Count of the number of bytes in the
    //                        sample buffer.
    //
    PWINBIO_BIR SampleBuffer;
    SIZE_T SampleSize;

} WINIBIO_SENSOR_CONTEXT, *PWINIBIO_SENSOR_CONTEXT;