IResourceManager::NotifyAcquire-Methode (strmif.h)

[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.]

Die NotifyAcquire -Methode benachrichtigt den Ressourcen-Manager darüber, dass der Versuch, eine Ressource zu erwerben, abgeschlossen ist.

Syntax

HRESULT NotifyAcquire(
  [in] LONG              idResource,
  [in] IResourceConsumer *pConsumer,
  [in] HRESULT           hr
);

Parameter

[in] idResource

Token für die registrierte Ressource.

[in] pConsumer

Zeiger auf die IResourceConsumer-Schnittstelle des Objekts, das die Ressource anfordert.

[in] hr

Wert, der den Erfolg der Übernahme angibt; S_OK, wenn die Ressource abgerufen wurde, oder einen Fehlerwert, falls nicht.

Rückgabewert

Gibt einen HRESULT-Wert zurück, der von der Implementierung abhängt. HRESULT kann eine der folgenden Standardkonstanten oder andere werte sein, die nicht aufgeführt sind.

Hinweise

Verwenden Sie diese Methode, nachdem eine IResourceConsumer::AcquireResource-Methode einen S_FALSE Wert zurückgibt, der angibt, dass die Erfassung asynchron ist (d. h. von einem Rückrufmechanismus behandelt). Wenn der hr-Parameter S_OK ist, geht der Ressourcen-Manager davon aus, dass die Ressource jetzt vom Aufrufer gehalten wird. Wenn der hr-Parameter etwas anderes als S_OK ist, geht der Ressourcen-Manager davon aus, dass der Versuch, die Ressource zu erwerben, fehlgeschlagen ist, und weist die Ressource an einer anderen Stelle neu zu.

Anforderungen

Weitere Informationen

Fehler- und Erfolgscodes

IResourceManager-Schnittstelle