estructura PCMETHOD_ITEM (portcls.h)

  • Artículo

La estructura PCMETHOD_ITEM describe un método admitido por un filtro, un pin o un nodo.

Sintaxis

typedef struct {
  const GUID          *Set;
  ULONG               Id;
  ULONG               Flags;
  PCPFNMETHOD_HANDLER Handler;
} PCMETHOD_ITEM, *PPCMETHOD_ITEM;

Miembros

Set

Especifica el conjunto de métodos. Este miembro es un puntero a un GUID que identifica de forma única el conjunto de métodos.

Id

Especifica el identificador del método. Este miembro identifica un elemento de método en el conjunto de métodos. Si el conjunto de métodos contiene n elementos, los identificadores de método válidos son enteros en el intervalo de 0 a n-1.

Flags

Especifica el tipo de paso de parámetros y el acceso a la memoria que usa un método. Este miembro se puede establecer en el OR bit a bit de uno o varios de los bits de marca de la tabla siguiente.

Bit de marca Significado
PCMETHOD_ITEM_FLAG_MODIFY El método lee y escribe en el búfer de parámetros.
PCMETHOD_ITEM_FLAG_NONE El método no usa el búfer de parámetros.
PCMETHOD_ITEM_FLAG_READ El método lee del búfer de parámetros.
PCMETHOD_ITEM_FLAG_SOURCE El método sondea y bloquea las páginas de memoria antes de intentar el acceso a la memoria.
PCMETHOD_ITEM_FLAG_WRITE El método escribe en el búfer de parámetros.

Handler

Puntero a la rutina del controlador de métodos. Este miembro es un puntero de función de tipo PCPFNMETHOD_HANDLER, que se define de la siguiente manera:

  typedef NTSTATUS (*PCPFNMETHOD_HANDLER)
  (
      IN PPCMETHOD_REQUEST  MethodRequest
  );

Al llamar a la rutina Handler , el autor de la llamada pasa un único parámetro de llamada, que es un puntero a una estructura de tipo PCMETHOD_REQUEST.

Comentarios

El subsistema de audio WDM no admite actualmente métodos en instancias de filtro ni en instancias de anclaje. Esta restricción también impide la compatibilidad con métodos en nodos.

La estructura PCAUTOMATION_TABLE contiene un puntero a una matriz de estructuras de PCMETHOD_ITEM.

Requisitos

Requisito Valor
Header portcls.h (incluya Portcls.h)

Consulte también

PCMETHOD_REQUEST