CImagePalette.MakeIdentityPalette-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 MakeIdentityPalette Methode versucht, eine "Identitätspalette" zu erstellen, die als eine definiert ist, die der im Anzeigegerät ausgewählten Palette direkt zugeordnet wird.

Syntax

HRESULT MakeIdentityPalette(
   PALETTEENTRY *pEntry,
   INT          iColours,
   LPSTR        szDevice
);

Parameter

pEntry

Zeiger auf ein Array von Paletteneinträgen.

iColours

Anzahl der Paletteneinträge in pEntry.

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 erfolgreich oder S_FALSE nicht erfolgreich ist.

Bemerkungen

Diese Methode vergleicht die reservierten Einträge in der Systempalette mit den entsprechenden Einträgen im pEntry-Array . Wenn sie genau übereinstimmen, legt die Methode das PC_NOCOLLAPSE-Flag in den verbleibenden (nicht reservierten) Paletteneinträgen in pEntry fest. Dieses Flag verhindert, dass GDI versucht, Einträge der logischen Palette Systempaletten zuzuordnen.

Die CImagePalette::MakePalette-Methode ruft diese Methode auf.

Anforderungen

Siehe auch

CImagePalette-Klasse