Freigeben über

IResourceManager::Register-Methode (strmif.h)

  • Artikel

[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 Register -Methode registriert eine einzelne benannte Ressource beim Ressourcen-Manager.

Syntax

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

Parameter

[in] pName

Benannte Ressource.

[in] cResource

Anzahl der Ressourcen.

[out] plToken

Zeiger auf das zurückgegebene Token, das die Ressource identifiziert, die in zusätzlichen Aufrufen verwendet werden soll.

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

Diese Methode registriert eine benannte Ressource, die eine Reihe von Ressourcen enthalten kann, und gibt ein Token zurück, das beim Anfordern dieser Ressource verwendet werden soll. Es handelt sich nicht um einen Fehler, wenn die Ressource bereits registriert ist. Wenn die Zahl im cResource-Parameter kleiner als die bereits registrierte ist, werden Ressourcen der neuen Anzahl zugeordnet. Um die Registrierung der Ressource aufzuheben, übergeben Sie die Anzahl null in cResource.

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