IPropertySetter::GetProps-Methode
[Das dieser Seite zugeordnete Feature DirectShow ist ein Legacyfeature. Es wurde durch MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation ersetzt. Diese Features wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code nach Möglichkeit MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation anstelle von DirectShow verwendet. Microsoft schlägt vor, vorhandenen Code, der die Legacy-APIs verwendet, um nach Möglichkeit die neuen APIs zu verwenden.]
Hinweis
[Veraltet. Diese API kann aus zukünftigen Versionen von Windows entfernt werden.]
Die GetProps -Methode ruft die für dieses Objekt festgelegten Eigenschaften mit den entsprechenden Werten ab.
Syntax
HRESULT GetProps(
[out] LONG *pcParams,
[out] DEXTER_PARAM **paParam,
[out] DEXTER_VALUE **paValue
);
Parameter
-
pcParams [out]
-
Empfängt die Anzahl der in paParam zurückgegebenen Strukturen.
-
paParam [out]
-
Adresse eines Zeigers auf ein Array von DEXTER_PARAM Strukturen.
-
paValue [out]
-
Adresse eines Zeigers auf ein Array von DEXTER_VALUE Strukturen.
Rückgabewert
Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.
Bemerkungen
Für jede in paParam zurückgegebene Eigenschaft gibt das nValues-Elementdie Anzahl DEXTER_VALUE Strukturen an, die der Eigenschaft zugeordnet sind. Die Paare werden in aufsteigender Zeitreihenfolge für jede Eigenschaft zurückgegeben.
Wenn Sie mit der Verwendung der zurückgegebenen Strukturen fertig sind, rufen Sie IPropertySetter::FreeProps auf, um die von dieser Methode zugewiesenen Ressourcen freizugeben.
Hinweis
Die Headerdatei Qedit.h ist nicht mit Direct3D-Headern ab Version 7 kompatibel.
Hinweis
Um Qedit.h zu erhalten, laden Sie das Microsoft Windows SDK Update für Windows Vista und .NET Framework 3.0 herunter. Qedit.h ist im Microsoft Windows SDK für Windows 7 und .NET Framework 3.5 Service Pack 1 nicht verfügbar.
Beispiele
Das folgende Codebeispiel zeigt, wie Sie alle Werte auf einer instance des Eigenschaftensetters durchlaufen:
IPropertySetter *pSetter = NULL;
// Get a valid IPropertySetter pointer (not shown).
DEXTER_PARAM *pParam;
DEXTER_VALUE *pValue;
LONG count;
hr = pSetter->GetProps(&count, &pParam, &pValue);
LONG num = 0;
for (LONG i = 0; i < count; i++)
{
for (LONG j = 0; j < pParam[i].nValues; j++)
{
// pValue[num] is the next value in the sequence for pParam[i]
}
num += pParam[i].nValues;
}
Anforderungen
| Anforderung | Wert |
|---|---|
| Header |
|
| Bibliothek |
|
Siehe auch