WUDF_WORKITEM_FUNCTION funzione di callback (wudfworkitem.h)

[Avviso: UMDF 2 è la versione più recente di UMDF e sostituisce UMDF 1. Tutti i nuovi driver UMDF devono essere scritti usando UMDF 2. Non vengono aggiunte nuove funzionalità a UMDF 1 ed è disponibile un supporto limitato per UMDF 1 nelle versioni più recenti di Windows 10. I driver di Windows universali devono usare UMDF 2. Per altre info, vedi Introduzione con UMDF.]

La funzione di callback dell'evento OnWorkItem di un driver esegue il lavoro associato a un elemento di lavoro specificato.

Sintassi

WUDF_WORKITEM_FUNCTION WudfWorkitemFunction;

void WudfWorkitemFunction(
  [in] IWDFWorkItem *pWorkItem
)
{...}

Parametri

[in] pWorkItem

Puntatore a un'interfaccia IWDFWorkItem .

Valore restituito

nessuno

Osservazioni

Per registrare una funzione di callback OnWorkItem , il driver deve inserire l'indirizzo della funzione di callback in una struttura di WUDF_WORKITEM_CONFIG prima di chiamare IWDFDevice3::CreateWorkItem.

In genere, la funzione di callback OnWorkItem di un driver esegue attività specificate dalle informazioni archiviate dal driver nella memoria di contesto di un oggetto elemento di lavoro.

Il driver non deve chiamare IWDFObject::D eleteWdfObject dalla funzione di callback OnWorkItem .

Per altre informazioni, vedere Uso di elementi di lavoro.

Esempio

Il tipo di funzione viene dichiarato in Wudfworkitem.h, come indicato di seguito.

typedef
VOID
WUDF_WORKITEM_FUNCTION(
    _In_
    IWDFWorkItem* pWorkItem
    );

typedef WUDF_WORKITEM_FUNCTION *PFN_WUDF_WORKITEM;

Per definire una funzione di callback OnWorkItem denominata MyWorkItem, è innanzitutto necessario fornire una dichiarazione di funzione richiesta da SDV e altri strumenti di verifica, come indicato di seguito:

WUDF_WORKITEM_FUNCTION  MyWorkItem;

Implementare quindi la funzione di callback come indicato di seguito:

VOID
  MyWorkItem (
   _In_
    IWDFWorkItem* pWorkItem
    )
  {…}

Requisiti

Requisito	Valore
Fine del supporto	Non disponibile in UMDF 2.0 e versioni successive.
Piattaforma di destinazione	Desktop
Versione UMDF minima	1.11
Intestazione	wudfworkitem.h

Vedi anche

IWDFDevice3::CreateWorkItem

IWDFObject::D eleteWdfObject

WUDF_WORKITEM_CONFIG