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

[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 Register método registra um único recurso nomeado com o gerenciador de recursos.

Sintaxe

HRESULT Register(
  [in]  LPCWSTR pName,
  [in]  LONG    cResource,
  [out] LONG    *plToken
);

Parâmetros

[in] pName

Recurso nomeado.

[in] cResource

Número de recursos.

[out] plToken

Ponteiro para o token retornado que identifica o recurso a ser usado em chamadas adicionais.

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.

Comentários

Esse método registra um recurso nomeado, que pode conter vários recursos, e retorna um token a ser usado ao solicitar esse recurso. Não será um erro se o recurso já estiver registrado; se o número no parâmetro cResource for menor do que o já registrado, os recursos serão desalocados para a nova contagem. Para cancelar o registro do recurso, passe uma contagem de zero em cResource.

Requisitos

Confira também

Códigos de erro e êxito

IResourceManager Interface