ITAllocatorProperties::SetAllocatorProperties-Methode (tapi3ds.h)

Die SetAllocatorProperties-Methode muss vor der Verbindung aufgerufen werden und erzwingt, dass der MSP diese Werte während der Filterverhandlung verwendet. Wenn der Verbindungsfilter diese Werte nicht akzeptiert, wird die Verbindung nicht hergestellt.

Syntax

HRESULT SetAllocatorProperties(
  [in] ALLOCATOR_PROPERTIES *pAllocProperties
);

Parameter

[in] pAllocProperties

Zeiger auf den Zuweisungspuffer.

Rückgabewert

Wenn die Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlerwert zurückgegeben.

Hinweise

Diese Methode sollte mit äußerster Sorgfalt verwendet werden. Die Qualität des Sounds kann beeinträchtigt werden, wenn die für diese Methode eingegebenen Werte für den MSP nicht optimal sind. Daher sollte die Anwendung vor dem Aufrufen dieser Methode genau die vom MSP bevorzugten Eigenschaften kennen. Unter Windows 2000 werden eigenschaften, die während der Aufrufe dieser Methode eingegeben wurden, ignoriert, wenn sie nicht optimal sind. Unter Windows XP werden diese Werte nicht ignoriert, und die Anwendung muss fähiger sein.

Wenn die Anwendung nur konsistente Puffergrößen festlegen möchte, sollte stattdessen die ITAllocatorProperties::SetBufferSize-Methode verwendet werden. Dadurch wird sichergestellt, dass die Anwendung mit der angegebenen Puffergröße bereitgestellt wird.

Anforderungen

Anforderung	Wert
Zielplattform	Windows
Kopfzeile	tapi3ds.h (tapi3.h einschließen)
Bibliothek	Uuid.lib
DLL	Tapi3.dll

Weitere Informationen

ITAllocatorProperties