Compartilhar via

Método IResourceManager::NotifyAcquire (strmif.h)

  • Artigo

[O recurso associado a esta página, DirectShow, é um recurso herdado. Foi substituído por MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation. Esses recursos foram otimizados para Windows 10 e Windows 11. A Microsoft recomenda fortemente que o novo código use MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation em vez de DirectShow, quando possível. A Microsoft sugere que o código existente que usa as APIs herdadas seja reescrito para usar as novas APIs, se possível.]

O NotifyAcquire método notifica o gerenciador de recursos de que uma tentativa de adquirir um recurso foi concluída.

Sintaxe

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

Parâmetros

[in] idResource

Token para o recurso registrado.

[in] pConsumer

Ponteiro para a interface IResourceConsumer do objeto que solicita o recurso.

[in] hr

Valor que indica o sucesso da aquisição; S_OK se o recurso foi adquirido ou um valor de erro, caso contrário.

Retornar valor

Retorna um valor HRESULT que depende da implementação. HRESULT pode ser uma das seguintes constantes padrão ou outros valores não listados.

Código de retorno Descrição
E_FAIL
 Falha.
E_POINTER
 Argumento de ponteiro NULL.
E_INVALIDARG
 Argumento inválido.
E_NOTIMPL
 Não há suporte para o método .
S_OK ou NOERROR
 Êxito.

Comentários

Use esse método depois que um método IResourceConsumer::AcquireResource retornar um valor S_FALSE, indicando que a aquisição será assíncrona (ou seja, tratada por um mecanismo de retorno de chamada). Se o parâmetro hr for S_OK, o gerenciador de recursos assumirá que o recurso agora é mantido pelo chamador. Se o parâmetro hr for algo diferente de S_OK, o gerenciador de recursos assumirá que a tentativa de adquirir o recurso falhou e reatribuirá o recurso em outro lugar.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho strmif.h (inclua Dshow.h)
Biblioteca Strmiids.lib

Confira também

Códigos de erro e êxito

IResourceManager Interface