OpcodeType Complex Type

Defines an operation within a component of the application. Used in conjunction with a task to identify the section of the application that is logging the event.

syntax

<xs:complexType name="OpcodeType"
    mixed="true"
>
    <xs:simpleContent>
        <xs:extension
            base="string"
        >
            <xs:attribute name="name"
                type="QName"
                use="required"
             />
            <xs:attribute name="symbol"
                type="CSymbolType"
                use="optional"
             />
            <xs:attribute name="value"
                type="UInt8Type"
                use="required"
             />
            <xs:attribute name="mofValue"
                type="UInt8Type"
                use="optional"
             />
            <xs:attribute name="message"
                type="strTableRef"
                use="optional"
             />
            <xs:anyAttribute
                processContents="lax"
                namespace="##other"
             />
        </xs:extension>
    </xs:simpleContent>
</xs:complexType>

Attributes

Name	Type	Description
message	strTableRef	The localized display name for the opcode. The message string references a localized string in the stringTable section of the manifest.
mofValue	UInt8Type	Reserved for internal use only.
name	QName	The name of the opcode. This name must be unique within the scope of this provider.
symbol	CSymbolType	The symbol to use to reference the opcode in your application. The Message Compiler (MC.exe) uses the symbol to create a constant for the opcode in the header file that the compiler generates. If you do not specify a symbol, the compiler generates one for you.
value	UInt8Type	The opcode value. You can specify values in the range 10 and 239. For a list of predefined opcode values, see Remarks.

Remarks

The following are the predefined opcode values that you can use. These values are defined in the Winmeta.xml file that is included in the Windows SDK.

Name	Value	Symbol	Description
win:Info	0	WINEVENT_OPCODE_INFO	An informational event.
win:Start	1	WINEVENT_OPCODE_START	An event that represents starting an activity.
win:Stop	2	WINEVENT_OPCODE_STOP	An event that represents stopping an activity. The event corresponds to the last unpaired start event.
win:DC_Start	3	WINEVENT_OPCODE_DC_START	An event that represents data collection starting. These are rundown event types.
win:DC_Stop	4	WINEVENT_OPCODE_DC_STOP	An event that represents data collection stopping. These are rundown event types.
win:Extension	5	WINEVENT_OPCODE_EXTENSION	An extension event.
win:Reply	6	WINEVENT_OPCODE_REPLY	A reply event.
win:Resume	7	WINEVENT_OPCODE_RESUME	An event that represents an activity resuming after being suspended.
win:Suspend	8	WINEVENT_OPCODE_SUSPEND	An event that represents the activity being suspended pending another activity's completion.
win:Send	9	WINEVENT_OPCODE_SEND	An event that represents transferring activity to another component.
win:Receive	240	WINEVENT_OPCODE_RECEIVE	An event that represents receiving an activity transfer from another component.

Requirements

Requirement	Value
Minimum supported client	Windows Vista [desktop apps only]
Minimum supported server	Windows Server 2008 [desktop apps only]