Fungsi AvRtWaitOnThreadOrderingGroup (avrt.h)

Memungkinkan utas klien dari grup pengurutan utas untuk menunggu hingga mereka harus dijalankan.

Sintaks

AVRTAPI BOOL AvRtWaitOnThreadOrderingGroup(
  [in] HANDLE Context
);

Parameter

[in] Context

Handel konteks. Handel ini dikembalikan oleh fungsi AvRtCreateThreadOrderingGroup atau AvRtJoinThreadOrderingGroup .

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan bukan nol.

Jika fungsi gagal, nilai yang dikembalikan adalah nol. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.

Keterangan

Ketika fungsi ini kembali, utas harus menyelesaikan pemrosesannya untuk periode tersebut dan kemudian memanggil fungsi lagi.

Jika utas gagal menyelesaikan pemrosesannya selama interval waktu habis yang ditentukan oleh utas induk saat membuat grup, utas tersebut akan dihapus dari grup pengurutan utas. Oleh karena itu, ketika utas menyelesaikan perulangan pemrosesannya, panggilan berikutnya ke AvRtWaitOnThreadOrderingGroup gagal dan kode kesalahan terakhir diatur ke ERROR_ACCESS_DENIED.

Jika grup pemesanan utas dihapus selama penantian, fungsi ini akhirnya kehabisan waktu dan kembali ERROR_ACCESS_DENIED.

Contoh

#include <windows.h>
#include <avrt.h>
#include <stdio.h>

#pragma comment(lib, "Avrt.lib")

HANDLE Context;

int main( void )
{
    while(AvRtWaitOnThreadOrderingGroup(Context))
    {
        // Complete task for this period.
    }

return 0;
}

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Target Platform	Windows
Header	avrt.h
Pustaka	Avrt.lib
DLL	Avrt.dll

Lihat juga

Layanan Pemesanan Utas