PIBIO_ENGINE_DETACH_FN funzione di callback (winbio_adapter.h)

Chiamato da Windows Biometric Framework immediatamente prima che un adattatore del motore venga rimosso dalla pipeline di elaborazione dell'unità biometrica. Lo scopo di questa funzione è rilasciare risorse specifiche della scheda associate alla pipeline.

Sintassi

PIBIO_ENGINE_DETACH_FN PibioEngineDetachFn;

HRESULT PibioEngineDetachFn(
  [in, out] PWINBIO_PIPELINE Pipeline
)
{...}

Parametri

[in, out] Pipeline

Puntatore a una struttura WINBIO_PIPELINE associata all'unità biometrica che esegue l'operazione.

Valore restituito

Se la funzione ha esito positivo, restituisce S_OK. Se la funzione ha esito negativo, deve restituire uno dei valori HRESULT seguenti per indicare l'errore.

Commenti

Per evitare perdite di memoria, l'implementazione della funzione EngineAdapterDetach deve rilasciare la struttura privata WINBIO_ENGINE_CONTEXT puntata dal membro EngineContext della pipeline insieme a qualsiasi altra risorsa collegata al contesto del motore.

Se il campo EngineContext nell'oggetto pipeline è NULL quando questa funzione viene chiamata, la pipeline non è stata inizializzata correttamente e è necessario restituire WINBIO_E_INVALID_DEVICE_STATE per notificare a Windows Biometric Framework il problema.

Prima di restituire S_OK, la funzione EngineAdapterDetach deve impostare il campo EngineContext della struttura WINBIO_PIPELINE su NULL e il campo EngineHandle su INVALID_HANDLE_VALUE.

Questa funzione viene chiamata dopo che l'adattatore di archiviazione è stato rimosso dalla pipeline. Pertanto, questa funzione non deve chiamare alcuna funzione a cui fa riferimento la struttura WINBIO_STORAGE_INTERFACE puntata dal membro StorageInterface dell'oggetto pipeline.

Esempio

Lo pseudocode seguente mostra una possibile implementazione di questa funzione. L'esempio non viene compilato. Devi adattarla per adattarti al tuo scopo.

//////////////////////////////////////////////////////////////////////////////////////////
//
// EngineAdapterDetach
//
// Purpose:
//      Releases adapter specific resources attached to the pipeline.
//      
// Parameters:
//      Pipeline -  Pointer to a WINBIO_PIPELINE structure associated with 
//                  the biometric unit.
//
static HRESULT
WINAPI
EngineAdapterDetach(
    __inout PWINBIO_PIPELINE Pipeline
    )
{
    PWINBIO_ENGINE_CONTEXT context = NULL;

    // Verify that the Pipeline parameter is not NULL.
    if (!ARGUMENT_PRESENT(Pipeline))
    {
        hr = E_POINTER;
        goto cleanup;
    }

    // Retrieve the context from the pipeline and assign it to a local
    // variable.
    context = (PWINBIO_ENGINE_CONTEXT)Pipeline->EngineContext;
    if (context == NULL)
    {
        goto cleanup;
    }

    // Set the context on the pipeline to NULL.
    Pipeline->EngineContext = NULL;

    // If your adapter supports software-based template hashing and you
    // opened a Cryptography Next Generation (CNG) hash object handle
    // during initialization, implement the following custom function to 
    // release the CNG resources.
    _AdapterCleanupCrypto(context);

    // Implement one or more custom routines to release any structures 
    // that remain attached to the context block. These structures can 
    // include the most recent feature set, the current enrollment template, 
    // and other custom defined objects.
    if (context->FeatureSet != NULL)
    {
        _AdapterRelease(context->FeatureSet);
        context->FeatureSet = NULL;
        context->FeatureSetSize = 0;
    }

    if (context->Enrollment.Template != NULL)
    {
        _AdapterRelease(context->Enrollment.Template);
        context->Enrollment.Template = NULL;
        context->Enrollment.TemplateSize = 0;
        context->Enrollment.SampleCount = 0;
    }

    if (context->SomePointerField != NULL)
    {
        _AdapterRelease(context->SomePointerField);
        context->SomePointerField = NULL;
    }

    // Release the context block.
    _AdapterRelease(context);

cleanup:

    return S_OK;
}

Requisiti

Vedi anche

EngineAdapterAttach

Funzioni plug-in

SensorAdapterDetach