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 informazioni, vedi Introduzione a UMDF.]
La funzione di callback di un driver OnWorkItem 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 un OnWorkItem funzione di callback, il driver deve inserire l'indirizzo della funzione di callback in una struttura WUDF_WORKITEM_CONFIG prima di chiamare IWDFDevice3::CreateWorkItem.
In genere, la OnWorkItem di un driver funzione di callback esegue attività specificate dalle informazioni archiviate dal driver nella memoria del 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.
Esempi
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 un OnWorkItem funzione di callback denominata MyWorkItem, è prima 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 segue:
VOID
MyWorkItem (
_In_
IWDFWorkItem* pWorkItem
)
{…}
Fabbisogno
| Requisito | Valore |
|---|---|
| Fine del supporto | Non disponibile in UMDF 2.0 e versioni successive. |
| piattaforma di destinazione | Desktop |
| versione minima di UMDF | 1.11 |
| intestazione | wudfworkitem.h |