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) |