Metodo IResourceManager::NotifyAcquire (strmif.h)

Articolo
03/02/2024

[La funzionalità associata a questa pagina, DirectShow, è una funzionalità legacy. È stata sostituita da MediaPlayer, FMMediaEngine e Audio/Video Capture in Media Foundation. Queste funzionalità sono state ottimizzate per Windows 10 e Windows 11. Microsoft consiglia vivamente che il nuovo codice usi MediaPlayer, FMMediaEngine e Audio/Video Capture in Media Foundation anziché DirectShow, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.

Il NotifyAcquire metodo notifica al gestore risorse che un tentativo di acquisizione di una risorsa è stato completato.

Sintassi

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

Parametri

[in] idResource

Token per la risorsa registrata.

[in] pConsumer

Puntatore all'interfaccia IResourceConsumer dell'oggetto che richiede la risorsa.

[in] hr

Valore che indica il successo dell'acquisizione; S_OK se la risorsa è stata acquisita o un valore di errore se non.

Valore restituito

Restituisce un valore HRESULT che dipende dall'implementazione. HRESULT può essere una delle costanti standard seguenti o altri valori non elencati.

Codice restituito	Descrizione
E_FAIL	Esito negativo.
E_POINTER	Argomento puntatore NULL.
E_INVALIDARG	Argomento non valido.
E_NOTIMPL	Il metodo non è supportato.
S_OK o NOERROR	Operazione completata.

Commenti

Usare questo metodo dopo un metodo IResourceConsumer::AcquireResource restituisce un valore S_FALSE, che indica che l'acquisizione sarà asincrona, ovvero gestita da un meccanismo di callback. Se il parametro hr è S_OK, resource manager presuppone che la risorsa sia ora contenuta dal chiamante. Se il parametro hr è diverso da S_OK, resource manager presuppone che il tentativo di acquisizione della risorsa non sia riuscito e riassegna la risorsa altrove.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	strmif.h (include Dshow.h)
Libreria	Strmiids.lib

Vedi anche

Codici errore e esito positivo

Interfaccia IResourceManager

Condividi tramite