PIBIO_ENGINE_IDENTIFY_ALL_FN回呼函式 (winbio_adapter.h)

由 Windows 生物特徵辨識架構呼叫，以判斷目前處於相機畫面的任何人員身分識別。

語法

PIBIO_ENGINE_IDENTIFY_ALL_FN PibioEngineIdentifyAllFn;

HRESULT PibioEngineIdentifyAllFn(
  [in, out] PWINBIO_PIPELINE Pipeline,
  [out]     PSIZE_T PresenceCount,
  [out]     PWINBIO_PRESENCE *PresenceArray
)
{...}

參數

[in, out] Pipeline

與執行作業之生物特徵辨識單位相關聯的 WINBIO_PIPELINE 結構的指標。

[out] PresenceCount

接收函式偵測到之目前狀態的變數位址。

[out] PresenceArray

接收 WINBIO_PRESENCE 元素陣列指標的變數位址。

傳回值

如果函式成功，它會 傳回S_OK。 如果函式失敗，它必須傳回下列其中一個 HRESULT 值，以指出錯誤。

備註

生物特徵辨識服務會在將新的數據框架傳送至引擎配接器之後呼叫這個方法。

處理數據框架之後，此函式應該會針對數據框架中偵測到的每個存在傳回一個 WINBIO_PRESENCE 元素。

如果 EngineAdapterIdentifyAll 函式在框架中找不到任何臉部，它會傳回S_OK的 HRESULT，並將 PresenceCount 和 PresenceArray 分別傳回參數設定為零和 NULL。 換句話說，不包含任何人類存在的框架不是錯誤狀況。

EngineAdapterIdentifyAll 的唯一時間應該傳回S_OK以外的 HRESULT，如果不想讓生物服務使用框架來更新目前狀態監視器狀態， 這應該是罕見的情況。 引擎配接器負責配置它在 PresenceArray 參數中傳回之WINBIO_PRESENCE元素的陣列。 它必須使用 HeapAlloc 函式，從進程堆積配置此記憶體。 建立陣列之後，它會成為Windows生物特徵辨識架構的屬性。 因為 Framework 會在使用它之後解除分配此記憶體，所以您的引擎配接器不得嘗試解除分配數位或儲存其指標。 無法遵循此規則會導致堆積損毀，以及生物特徵辨識服務的可能損毀。

PresenceArray 中個別WINBIO_PRESENCE專案的值會決定為用戶端應用程式產生的事件。 如需詳細資訊，請參閱 WINBIO_PRESENCE 結構的討論。

規格需求