Fungsi WdfWorkItemGetParentObject (wdfworkitem.h)

[Berlaku untuk KMDF dan UMDF]

Metode WdfWorkItemGetParentObject mengembalikan objek kerangka kerja yang terkait dengan item kerja tertentu.

Sintaks

WDFOBJECT WdfWorkItemGetParentObject(
  [in] WDFWORKITEM WorkItem
);

Parameter

[in] WorkItem

Handel ke objek item kerja kerangka kerja yang diperoleh dari panggilan sebelumnya ke WdfWorkItemCreate.

Nilai kembali

WdfWorkItemGetParentObject mengembalikan handel ke objek kerangka kerja yang ditentukan driver sebagai anggota ParentObject dari struktur WDF_OBJECT_ATTRIBUTES driver ketika driver yang sebelumnya disebut WdfWorkItemCreate.

Pemeriksaan bug terjadi jika driver menyediakan handel objek yang tidak valid.

Keterangan

Untuk informasi selengkapnya tentang item kerja, lihat Menggunakan Item Kerja Kerangka Kerja.

Contoh

Contoh kode berikut adalah fungsi panggilan balik EvtWorkItem dari driver sampel 1394 . Contoh mendapatkan objek perangkat induk item kerja, memanggil rutinitas yang ditentukan driver untuk memproses item kerja, lalu menghapus objek item kerja.

VOID
t1394_BusResetRoutineWorkItem(
    IN WDFWORKITEM  WorkItem
)
{
    WDFDEVICE  Device = WdfWorkItemGetParentObject(WorkItem);

    t1394_UpdateGenerationCount(Device);

    WdfObjectDelete(WorkItem);
}

Persyaratan

Persyaratan	Nilai
Target Platform	Universal
Versi KMDF minimum	1,0
Versi UMDF minimum	2.0
Header	wdfworkitem.h (termasuk Wdf.h)
Pustaka	Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL	<= DISPATCH_LEVEL
Aturan kepatuhan DDI	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Lihat juga

WDF_OBJECT_ATTRIBUTES

WdfWorkItemBuat