PDEV_QUERY_RESULT_CALLBACK funzione di callback (devquery.h)

Articolo
11/15/2024

Prototipo di funzione richiesto dalle funzioni di callback che riceveranno i risultati della query DevQuery.

Sintassi

PDEV_QUERY_RESULT_CALLBACK PdevQueryResultCallback;

void PdevQueryResultCallback(
  HDEVQUERY hDevQuery,
  PVOID pContext,
  const DEV_QUERY_RESULT_ACTION_DATA *pActionData
)
{...}

Parametri

hDevQuery

Handle per la query associata al callback.

pContext

Valore di contesto facoltativo fornito dal client durante la creazione della query.

pActionData

Struttura DEV_QUERY_RESULT_ACTION_DATA che fornisce informazioni sulla modifica allo stato della query o sull'azione applicata al set di risultati. I dati in questa struttura verranno liberati una volta restituito il callback.

Valore restituito

Nessuno

Osservazioni

Una sola funzione di callback è sempre attiva per una determinata query. Se la stessa funzione di callback viene passata a più query, è possibile che le funzioni di callback vengano eseguite simultaneamente, perché possono essere richiamate per query diverse.

È possibile chiamare DevCloseObjectQuery nel handle hDevQuery dal callback se il flag DevQueryFlagAsyncClose è stato specificato al momento della creazione della query. Se non è stato specificato DevQueryFlagAsyncClose, la chiamata di DevCloseObjectQuer y su una query dall'interno del proprio callback genererà un deadlock.

Fabbisogno

Requisito	Valore
intestazione	devquery.h

Condividi tramite