Expand Minimize

KSIDENTIFIER structure

The KSIDENTIFIER structure specifies a GUID that uniquely identifies a related set of GUIDs, and an index value to refer to a specific member within that set.

Syntax


typedef struct {
  union {
    struct {
      GUID  Set;
      ULONG Id;
      ULONG Flags;
    };
    LONGLONG Alignment;
  };
} KSIDENTIFIER, *PKSIDENTIFIER;

Members

Set

Specifies the globally unique set identifier.

Id

Specifies the set-specific identifier for an item within the set.

Flags

Specifies values used for various set types, such as properties and methods. Zero when not used.

Alignment

Not used. A member of an unnamed union used to force proper alignment on the unnamed structure.

Remarks

The KSEVENT, KSMETHOD, and KSPROPERTY structures are aliases for the KSIDENTIFIER structure. As such, their definitions are identical.

The use of an ID within the set allows one to perform a single large compare for a set identifier, then smaller quick compares (for example, by using a switch statement for identifiers within a set). For example, a property set is referred to by a unique GUID identifier, and properties within that set are referred to by the short ID.

Method, Event, Interface, and medium sets can be thought of as "classes" of sets.

Requirements

Header

Ks.h (include Ks.h)

See also

KSEVENT
KSMETHOD
KSPROPERTY

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft