struttura PCMETHOD_ITEM (portcls.h)

La struttura PCMETHOD_ITEM descrive un metodo supportato da un filtro, un pin o un nodo.

Sintassi

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

Members

Set

Specifica il set di metodi. Questo membro è un puntatore a un GUID che identifica in modo univoco il set di metodi.

Id

Specifica l'ID del metodo. Questo membro identifica un elemento del metodo nel set di metodi. Se il set di metodi contiene n elementi, gli ID metodo validi sono integer nell'intervallo da 0 a n-1.

Flags

Specifica il tipo di parametro che passa e l'accesso alla memoria utilizzato da un metodo. Questo membro può essere impostato sull'OR bit per bit di uno o più bit del flag nella tabella seguente.

Flag bit	Significato
PCMETHOD_ITEM_FLAG_MODIFY	Il metodo legge e scrive nel buffer dei parametri.
PCMETHOD_ITEM_FLAG_NONE	Il metodo non usa il buffer dei parametri.
PCMETHOD_ITEM_FLAG_READ	Il metodo legge dal buffer dei parametri.
PCMETHOD_ITEM_FLAG_SOURCE	Il metodo esegue il probe e blocca le pagine di memoria prima di tentare l'accesso alla memoria.
PCMETHOD_ITEM_FLAG_WRITE	Il metodo scrive nel buffer dei parametri.

Handler

Puntatore alla routine del gestore del metodo. Questo membro è un puntatore a funzione di tipo PCPFNMETHOD_HANDLER, definito come segue:

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

Quando si chiama la routine Handler , il chiamante passa un singolo parametro di chiamata, ovvero un puntatore a una struttura di tipo PCMETHOD_REQUEST.

Commenti

Il sottosistema audio WDM attualmente non supporta i metodi nelle istanze di filtro o nelle istanze del pin. Questa restrizione impedisce anche il supporto per i metodi nei nodi.

La struttura PCAUTOMATION_TABLE contiene un puntatore a una matrice di strutture PCMETHOD_ITEM.

Requisiti

Requisito	Valore
Intestazione	portcls.h (include Portcls.h)

Vedi anche

PCMETHOD_REQUEST