Metodo IResourceManager::NotifyAcquire (strmif.h)

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

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

Vedi anche

Codici errore e esito positivo

Interfaccia IResourceManager