Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Questa sezione descrive i set di proprietà specifici dell'API codec e del codificatore disponibili per i minidriver del codificatore che usano i servizi di streaming del kernel WDM in Microsoft Windows 98/Me, Windows 2000 e Windows XP e versioni successive.
La pagina di riferimento per ogni proprietà contiene una tabella con le intestazioni di colonna illustrate di seguito.
| Get | Set | Target | Tipo descrittore di proprietà | Tipo di valore della proprietà |
|---|---|---|---|---|
Queste intestazioni hanno i significati seguenti:
Get
L'oggetto KS di destinazione supporta la richiesta di proprietà KSPROPERTY_TYPE_GET?
Set
L'oggetto KS di destinazione supporta la richiesta di proprietà KSPROPERTY_TYPE_SET?
Target
Si tratta dell'oggetto KS a cui viene inviata la richiesta di proprietà. La destinazione per una proprietà del codificatore video è un filtro o un pin. La richiesta di proprietà specifica l'oggetto di destinazione dal relativo handle del kernel.
Tipo descrittore di proprietà
Il descrittore di proprietà specifica la proprietà e l'operazione da eseguire su tale proprietà. The descriptor always begins with a KSPROPERTY structure.
Tipo di valore della proprietà
Una proprietà ha un valore e il tipo di questo valore dipende dalla proprietà . Ad esempio, una proprietà che può trovarsi in uno solo due stati, on o off, ha in genere un valore BOOL. Una proprietà che può presupporre valori interi da 0x0 a 0xFFFFFFFF potrebbe avere un valore ULONG. Le proprietà più complesse possono avere valori che sono matrici o strutture.
Il descrittore di proprietà e il valore della proprietà precedenti sono le versioni specifiche delle proprietà dei buffer delle specifiche dell'istanza e dei buffer dei dati dell'operazione descritti in Proprietà KS, Eventi e Metodi.
Una richiesta di proprietà usa uno dei flag seguenti per specificare l'operazione da eseguire sulla proprietà :
KSPROPERTY_TYPE_BASICSUPPORT
KSPROPERTY_TYPE_GET
KSPROPERTY_TYPE_SET
Tutti gli oggetti filtro e pin supportano l'operazione di supporto di base sulle relative proprietà. Whether they support the get and Set operations depends on the property. A property that represents an inherent capability of the filter or pin object is likely to require only a get operation. A property that represents a configurable setting might require only a Set operation, although a get operation might also be useful for reading the current setting. For more information about using the get, set, and basic-support operations with video encoder properties, see KS Properties.
Una tabella nella descrizione di ogni proprietà indica se i minidriver del codificatore video sono necessari per supportare la lettura o la scrittura della proprietà. I minidriver del codificatore video devono restituire STATUS_NOT_SUPPORTED in risposta a ottenere o impostare richieste di proprietà non supportate dal minidriver.
La proprietà seguente imposta ognuna di esse una singola proprietà che deve essere implementata dai minidriver del codificatore video. That is, effectively each property gets its own set, so specify 0 in the PropertyId member of the KSPROPERTY_ITEM member in the KSPROPERTY_SET structure as required.
I set di proprietà seguenti appartengono all'API codec:
I set di proprietà seguenti appartengono all'API del codificatore: