Funzione WdfTimerGetParentObject (wdftimer.h)

Articolo
08/08/2023

[Si applica a KMDF e UMDF]

Il metodo WdfTimerGetParentObject restituisce un handle all'oggetto padre di un oggetto timer del framework specificato.

Sintassi

WDFOBJECT WdfTimerGetParentObject(
  [in] WDFTIMER Timer
);

Parametri

[in] Timer

Handle a un oggetto timer del framework ottenuto chiamando WdfTimerCreate.

Valore restituito

WdfTimerGetParentObject restituisce un handle all'oggetto framework che è l'oggetto padre dell'oggetto timer specificato.

Un controllo di bug si verifica se il driver fornisce un handle di oggetti non valido.

Commenti

Per altre informazioni sugli oggetti timer del framework, vedere Uso di Timer.

Esempio

L'esempio di codice seguente mostra ora una funzione di callback EvtTimerFunc può ottenere un elemento padre di un oggetto timer. In questo esempio il driver ha specificato in precedenza che il padre dell'oggetto timer è un oggetto queue.

VOID
MyEvtTimerFunc(
    IN WDFTIMER  Timer
    )
{
    WDFQUEUE queue;

    queue = WdfTimerGetParentObject(Timer);
...
}

Requisiti

Requisito	Valore
Piattaforma di destinazione	Universale
Versione KMDF minima	1.0
Versione UMDF minima	2,0
Intestazione	wdftimer.h (include Wdf.h)
Libreria	Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL	<=DISPATCH_LEVEL
Regole di conformità DDI	DriverCreate(kmdf)

Vedi anche

WdfTimerCreate

Condividi tramite