IResourceManager::NotifyAcquire-Methode (strmif.h)

Artikel
03/02/2024

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

Rückgabecode	Beschreibung
E_FAIL	Fehler.
E_POINTER	NULL-Zeigerargument.
E_INVALIDARG	Ungültiges Argument.
E_NOTIMPL	Die Methode wird nicht unterstützt.
S_OK oder NOERROR	Erfolg.

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

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	strmif.h (include Dshow.h)
Bibliothek	Strmiids.lib

Weitere Informationen

Fehler- und Erfolgscodes

IResourceManager-Schnittstelle

Freigeben über