CImagePalette.PreparePalette-Methode

[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 PreparePalette -Methode richtet eine Palette basierend auf einem Medientyp aus dem besitzenden Filter ein.

Syntax

HRESULT PreparePalette(
   const CMediaType *pmtNew,
   const CMediaType *pmtOld,
         LPSTR      szDevice
);

Parameter

pmtNew

Zeiger auf den neuen Medientyp. Der Formatblock muss eine VIDEOINFOHEADER-Struktur sein.

pmtOld

Zeiger auf den alten Medientyp. Wenn der Medientyp zum ersten Mal festgelegt wird, kann es sich bei diesem Parameter um einen leeren Typ ohne Formatblock handeln. Andernfalls muss der Formatblock eine VIDEOINFOHEADER-Struktur sein.

szDevice

Zeiger auf eine Zeichenfolge, die den Namen des Anzeigegeräts enthält, wie von der GDI-Funktion EnumDisplayDevices zurückgegeben wird. Um das Standard Anzeigegerät zu verwenden, legen Sie diesen Parameter auf NULL fest.

Rückgabewert

Gibt S_OK zurück, wenn die Palette aktualisiert wurde, oder S_FALSE, wenn sich die Palette nicht geändert hat.

Bemerkungen

Wenn die Palette aktualisiert werden muss, führt diese Methode die folgenden Aktionen aus:

• Ruft CImagePalette::MakePalette auf, um eine neue logische Palette zu erstellen.
• Sendet ein EC_PALETTE_CHANGED-Ereignis an den Filter Graph-Manager.
• Ruft CBaseWindow::SetPalette für das CBaseWindow-Objekt auf.
• Ruft CDrawImage::IncrementPaletteVersion für das CDrawImage-Objekt auf.

Anforderungen

Siehe auch

CImagePalette-Klasse