VSInstr

أداة VSInstr هو المستخدمة للتجهيزات الثنائيات. هو استدعاء باستخدام بناء الجملة التالي:

VSInstr [/U] filename [/options]

يصف الجدول التالي خيارات أداة VSInstr:

خيارات

الوصف

Help أو ?

عرض التعليمات.

U

قم بكتابة إخراج وحدة التحكم الذي تمت إعادة توجيهه كـ Unicode. يجب أن يكون خيار أول المحدد.

@filename

تعين اسم ملف الاستجابة يتضمن خيار أمر واحد في كل سطر. لا استخدم علامات الاقتباس.

OutputPath:path

تحديد الدليل وجهة للآلية نسخة. إذا لم يتم تحديد مسار إخراج الثنائي الأصلي قد أعيدت تسميته بإلحاق "Orig" ملف اسم في نفس الدليل، ونسخ من الملف الثنائي تم instrumented.

Exclude:funcspec

يحدد مواصفة دالة إلى استبعاد من آلات ب probes. هو مفيدة عند إنشاء تشكيل جانبي فحص الإدراج في دالة يؤدي إلى نتائج غير متوقعة أو غير المرغوب فيها.

لا تستخدم Excludeو Includeخيارات التي تشير إلى الدالات في نفس الملف الثنائي.

يمكن تحديد مواصفات دالة عدة منفصلة Excludeخيارات.

funcspecهو المعرفة ك:

[مساحة الاسم <separator1>] دالة [فئة <separator2>]

هو <separator1> ::للتعليمات البرمجية الأصلية، و .للتعليمات البرمجية المدارة.

<separator2> هو دائماً ::

Excludeهو معتمدة بتغطية من تعليمات برمجية.

حرف بدل * هو معتمدة. على سبيل المثال، إلى استبعاد الجميع الدالات في استخدام مساحة الاسم:

MyNamespace:: *

يمكنك استخدام VSInstr /DumpFuncsإلى سرد أسماء كاملة من الدالات في الملف الثنائي المحدد.

Include:funcspec

قم بتحديد مواصفات دالة بثنائي إلى آلة مع probes. الجميع لم يتم instrumented وظائف غير ذلك في الثنائيات.

يمكنك تحديد عدة مواصفات دالة مع فصل Includeالخيارات.

لا تستخدم Includeو Excludeخيارات التي تشير إلى الدالات في نفس الملف الثنائي.

Includeهو غير معتمد مع تعليمات برمجية تغطية.

funcspecهو المعرفة ك:

[مساحة الاسم <separator1>] دالة [فئة <separator2>]

هو <separator1> ::للتعليمات البرمجية الأصلية، و .للتعليمات البرمجية المدارة.

<separator2> هو دائماً ::

حرف بدل * هو معتمدة. على سبيل المثال، إلى تضمين الجميع الدالات في استخدام مساحة الاسم:

MyNamespace:: *

يمكنك استخدام VSInstr /DumpFuncsإلى سرد أسماء كاملة من الدالات في الملف الثنائي المحدد.

DumpFuncs

تسرد دالات داخل الصورة المعينة. لا توجد آلات هو تنفيذه.

ExcludeSmallFuncs

تستثني صغيرة دالات، وهي قصير دالات التي لا تقم بإجراء أية مكالمات هاتفية دالة من آلات. ExcludeSmallFuncsتوفر خيار لحمل آلات أقل سرعة آلات المحسنة وهكذا.

استثناء الدالات مربع متوسط أيضا بتقليل الحجم الملف.vsp و الوقت المطلوب للتحليل.

Mark:{Before|After|Top|Bottom},funcname,markid

يدرج علامة التشكيل جانبي (معرّف المستخدم إلى لتحديد بيانات في التقارير) التي يمكن استخدامها إلى تعريف بداية أو إنهاء نطاق بيانات في ملف التقرير.vsp.

Before-مباشرة قبل دالة الهدف إدخال.

After-مباشرة بعد دالة الهدف خروج.

Top-مباشرة بعد دالة الهدف إدخال.

Bottom-مباشرة قبل كل العودة في دالة الهدف.

funcname-اسم دالة الهدف

Markid-عددا صحيحاً موجباً (طويل) إلى استخدامه كمعرّف لعلامة يحلل.

Coverage

قم بأداء آلات تغطية. يمكن دمجها مع خيار OutputPath.

Verbose

Verboseخيار هو المستخدم لعرض معلومات مُفصل حول عملية آلات.

NoWarn[:[Message Number[;Message Number]]]

منع الجميع أو تحذيرات معينة.

Message Number-رقم تحذير. إذا Message Numberهو، يتم منع الجميع التحذيرات.

لمزيد من المعلومات، راجع تحذيرات VSInstr.

Control:{Thread|Process|Global}

تحديد المستوى بيانات VSInstr التالية profiling مجموعة عنصر تحكم خيارات:

Start

StartOnly

Suspend

StopOnly

SuspendOnly

ResumeOnly

Thread-قم بتحديد عنصر تحكم مجموعة بيانات مؤشر ترابط المستوى دالات. إنشاء تشكيل جانبي هو بدء تشغيل أو إيقاف لمسار التنفيذ الحالي فقط. حالة profiling من عمليات جزئية الأخرى هو لا تتأثر. القيمة الافتراضية هو مؤشر ترابط.

Process-تحديد عملية-المستوى إنشاء ملفات تعريف بيانات مجموعة التحكم وظائف. إنشاء تشكيل جانبي تشغيل أو إيقاف لكافة عمليات جزئية في العملية الحالي. لا يتأثر بحالة profiling معالجات الأخرى.

Global-قم بتحديد عنصر تحكم مجموعة البيانات (عملية مشتركة) المستوى العمومي دالات.

يحدث خطأ إذا لم تقم بتعيين المستوى profiling.

Start:{Inside|Outside},funcname

قم بتحديد مجموعة بيانات إلى دالة الهدف والوظائف التابعة استدعاؤها بواسطة هذه دالة.

إدراج Inside-StartProfile تعمل مباشرة بعد إدخال إلى دالة الهدف. قم بإدراج دالة StopProfile قبل كل العائد مباشرة في دالة الهدف.

Outside-يدرج الدالة StartProfile مباشرة قبل كل يتصل إلى دالة الهدف. يدرج دالة SإلىpProfile مباشرة بعد كل استدعاء إلى دالة الهدف.

funcname-اسم دالة الهدف.

Suspend:{Inside|Outside},funcname

تستثني جمع بيانات للدالة الهدف والوظائف التابعة استدعاؤها بواسطة دالة.

Inside-يدرج دالة SuspendProfile مباشرة بعد الإدخال إلى دالة الهدف. قم بإدراج دالة ResumeProfile قبل كل العائد مباشرة في دالة الهدف.

Outside-يدرج دالة SuspendProfile مباشرة قبل إدخال دالة الهدف. يدرج الدالة ResumeProfile مباشرة بعد الخروج من دالة الهدف.

funcname-اسم دالة الهدف.

إذا كانت الدالة الهدف تحتوي على دالة StartProfile، الدالة SuspendProfile هو إدراج قبله. إذا كانت الدالة الهدف تحتوي على دالة StopProfile، الدالة ResumeProfile هو إدراجه بعد ذلك.

StartOnly:{Before|After|Top|Bottom},funcname

تبدأ بيانات مجموعة أثناء إنشاء ملفات تعريف تشغيل. يقوم بإدراج دالة API StartProfile في الموقع المحدد.

Before-مباشرة قبل دالة الهدف إدخال.

After-مباشرة بعد الهدف دالة. إنهاء

Top-مباشرة بعد الهدف تعمل الإدخال.

Bottom-مباشرة قبل كل العودة في دالة الهدف.

funcname-اسم دالة الهدف.

StopOnly:{Before|After|Top|Bottom},funcname

توقف بيانات مجموعة أثناء إنشاء ملفات تعريف تشغيل. يقوم بإدراج دالة StopProfile في الموقع المحدد.

Before-مباشرة قبل دالة الهدف إدخال.

After-مباشرة بعد الهدف دالة. إنهاء

Top-مباشرة بعد الهدف تعمل الإدخال.

Bottom-مباشرة قبل كل العودة في دالة الهدف.

funcname-اسم دالة الهدف.

SuspendOnly:{Before|After|Top|Bottom},funcname

توقف بيانات مجموعة أثناء إنشاء ملفات تعريف تشغيل. يقوم بإدراج API SuspendProfile في الموقع المحدد.

Before-مباشرة قبل دالة الهدف إدخال.

After-مباشرة بعد الهدف دالة. إنهاء

Top-مباشرة بعد الهدف تعمل الإدخال.

Bottom-مباشرة قبل كل العودة في دالة الهدف.

funcname-اسم دالة الهدف.

إذا كانت الدالة الهدف تحتوي على دالة StartProfile، الدالة SuspendProfile هو إدراج قبله.

ResumeOnly:{Before|After|Top|Bottom},funcname

يبدأ أو استئناف جمع بيانات أثناء ملفات التعريف تشغيل.

ويستخدم عادة ل يبدأ إنشاء تشكيل جانبي بعد SuspendOnlyتوقف خيار إنشاء تشكيل جانبي. يقوم بإدراج API ResumeProfile في الموقع المحدد.

Before-مباشرة قبل دالة الهدف إدخال.

After-مباشرة بعد الهدف دالة. إنهاء

Top-مباشرة بعد الهدف تعمل الإدخال.

Bottom-مباشرة قبل كل العودة في دالة الهدف.

funcname-اسم دالة الهدف.

إذا كانت الدالة الهدف تحتوي على دالة StopProfile، الدالة ResumeProfile هو إدراجه بعد ذلك.

راجع أيضًا:

المرجع

VSPerfMon

VSPerfCmd

مورد تفاصيل عرض-بيانات محتوى محلل ملفات التعريف

تحذيرات VSInstr

موارد أخرى

إنشاء طرق عرض تقرير أدوات تشكيل جانبي