Methode ITcRTimeTask::GetCpuAccount()

Abfrage des CPU-Accounts einer TwinCAT Task.

Syntax

virtual HRESULT TCOMAPI GetCpuAccount(PULONG pAccount)=0;

Parameter

pAccount: (Typ: PULONG) [out] TwinCAT Task CPU-Account ist in diesem Parameter gespeichert.

Rückgabewert

Bei Erfolg wird S_OK („0“) oder ein anderer positiver Wert zurückgegeben, vgl. Rückgabewerte. Erweiterte Meldungen beziehen sich dabei insbesondere auf die Spalte HRESULT in ADS Return Codes.

E_POINTER wenn Parameter pAccount gleich NULL.

Beschreibung

Mit Hilfe der GetCpuAccount() Methode kann die aktuelle, für die Task aufgewendete Rechenzeit abgefragt werden.

Code-Ausschnitt, der die Verwendung von GetCpuAccount() zeigt, z. B. innerhalb einer ITcCyclic::CycleUpdate() Methode:


// CPU account in 100 ns interval
ITcRTimeTaskPtr spRTimeTask = ipTask;
ULONG nCpuAccountForComputeSomething = 0;
if (spRTimeTask != NULL)
{
ULONG nStart = 0;
hr = FAILED(hr) ? hr : spRTimeTask->GetCpuAccount(&nStart);

ComputeSomething();

ULONG nStop = 0;
hr = FAILED(hr) ? hr : spRTimeTask->GetCpuAccount(&nStop);

nCpuAccountForComputeSomething = nStop - nStart;
}