Metodo IWDFDevice3::CreateWorkItem (wudfddi.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. Nessuna nuova funzionalità viene aggiunta 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, vedere Introduzione con UMDF.]

Il metodo CreateWorkItem crea un oggetto work-item del framework, che può successivamente essere aggiunto alla coda dell'elemento di lavoro del framework.

Sintassi

HRESULT CreateWorkItem(
  [in]           PWUDF_WORKITEM_CONFIG pConfig,
  [in, optional] IWDFObject            *pParentObject,
  [out]          IWDFWorkItem          **ppWorkItem
);

Parametri

[in] pConfig

Puntatore a una struttura WUDF_WORKITEM_CONFIG allocata dal chiamante che il driver deve avere già inizializzato chiamando WUDF_WORKITEM_CONFIG_INIT.

[in, optional] pParentObject

Puntatore all'interfaccia dell'oggetto padre o NULL.

[out] ppWorkItem

Puntatore a un buffer che riceve un puntatore all'interfaccia IWDFWorkItem per il nuovo oggetto WorkItem.

Valore restituito

Il metodo restituisce S_OK se l'operazione ha esito positivo. In caso contrario, questo metodo restituisce uno dei codici di errore definiti in Winerror.h.

Commenti

Se si specifica un oggetto padre, il framework elimina automaticamente l'elemento di lavoro quando l'oggetto padre viene eliminato. In alternativa, il driver può chiamare IWDFObject::D eleteWdfObject per eliminare un elemento di lavoro. Il driver non deve eliminare un elemento di lavoro nella funzione di callback OnWorkItem .

Per altre informazioni, vedere Uso di elementi di lavoro.

Esempio

WUDF_WORKITEM_CONFIG config;
        
WUDF_WORKITEM_CONFIG_INIT(&config, OnWorkItem); 
hr = m_IWdfDevice3->CreateWorkItem(&config,
                                   m_IWdfDevice3,   
                                   &m_WorkItem);

Requisiti

   
Fine del supporto Non disponibile in UMDF 2.0 e versioni successive.
Piattaforma di destinazione Desktop
Versione UMDF minima 1.11
Intestazione wudfddi.h
DLL WUDFx.dll

Vedi anche

IWDFDevice3

IWDFWorkItem

OnWorkItem

WUDF_WORKITEM_CONFIG

WUDF_WORKITEM_CONFIG_INIT