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;
Membri
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 compresi 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.
| Bit flag | 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 gestore, il chiamante passa un singolo parametro di chiamata, ovvero un puntatore a una struttura di tipo PCMETHOD_REQUEST.
Osservazioni
Il sottosistema audio WDM attualmente non supporta i metodi nelle istanze di filtro o nelle istanze di 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.
Fabbisogno
| Requisito | Valore |
|---|---|
| intestazione | portcls.h (include Portcls.h) |