Struttura KSMETHOD
La struttura KSMETHOD specifica un singolo metodo di streaming del kernel all'interno di un set di metodi.
Le strutture KSEVENT, KSMETHOD e KSPROPERTY sono alias per la struttura KSIDENTIFIER . Di conseguenza, le loro definizioni sono identiche.
Sintassi
struct KSMETHOD {
GUID Set;
ULONG Id;
ULONG Flags;
};
Members
Set
Specifica un GUID che identifica un set di metodi di streaming del kernel.
Per altre informazioni sui GUID del set di metodi, vedere la sezione Osservazioni di seguito.
Id
Specifica il membro del set di metodi.
Flags
Specifica il tipo di richiesta. Vedere anche i flag di KSMETHOD_TYPE_Xxx per KSMETHOD_ITEM).
Una richiesta può contenere una combinazione dei valori elencati nella tabella seguente.
| Valore | Tipo di richiesta di metodo |
|---|---|
| KSMETHOD_TYPE_BASICSUPPORT | Indica di eseguire una query sul minidriver per determinare se supporta il metodo specificato del set di metodi. |
| KSMETHOD_TYPE_SEND | Indica che il minidriver deve eseguire il metodo specificato. L'effetto del metodo sui parametri specificati deve essere noto al client, ovvero se i parametri vengono letti da, scritti in, entrambi o nessuno dei due. Il minidriver usa la struttura KSMETHOD_ITEM per specificare l'effetto del metodo sui parametri. |
| KSMETHOD_TYPE_SETSUPPORT | Indica di eseguire una query sul minidriver per determinare se supporta il set di metodi specificato. |
| KSMETHOD_TYPE_TOPOLOGY | Indica che il metodo specificato è di tipo KSM_NODE, dove il membro NodeId è l'identificatore del nodo della topologia. Non impostare questo flag da solo; invece, OR con altri flag da questo elenco. |
Commenti
Microsoft offre diversi GUID del set di metodi definiti dal sistema. I minidriver specificano uno di questi GUID nel membro Set . I set di metodi di streaming del kernel iniziano in genere con un prefisso KSMETHODSETID . I set di metodi di streaming del kernel sono definiti in ks.h, ksmedia.h, bdamedia.h e possibilmente altri file di intestazione.
Per altre informazioni sugli eventi di streaming del kernel, vedere Proprietà, eventi e metodi KS.
Un client può usare la richiesta di IOCTL_KS_METHOD insieme alla struttura KSMETHOD per eseguire metodi in un oggetto di streaming del kernel gestito dal minidriver. Per altre informazioni, vedere Metodi KS.
Requisiti
Intestazione: ks.h (includere Ks.h)