Metodo ITocEntry::GetDescriptionData (wmcodecdsp.h)

Articolo
03/04/2024

Il metodo GetDescriptionData ottiene un blocco di dati di descrizione precedentemente associato alla voce da una chiamata a SetDescriptionData.

Sintassi

HRESULT GetDescriptionData(
  [in, out] DWORD *pdwDescriptionDataSize,
  [out]     BYTE  *pbtDescriptionData,
  [out]     GUID  *pGuidType
);

Parametri

[in, out] pdwDescriptionDataSize

Se pbtDescriptionData è NULL, si tratta di un parametro di output che riceve le dimensioni, in byte, del blocco di dati di descrizione. Se pbtDescriptionData non è NULL, si tratta di un parametro di input che specifica le dimensioni, in byte, del buffer allocato dal chiamante a cui punta pbtDescriptionData.

[out] pbtDescriptionData

NULL o un puntatore a un buffer allocato dal chiamante che, al completamento corretto, riceve il blocco di dati di descrizione.

[out] pGuidType

Puntatore a una variabile che riceve un identificatore univoco globale (GUID) che identifica il tipo di dati nel blocco di dati description. Vedere la sezione Osservazioni.

Valore restituito

Il metodo restituisce un valore HRESULT. I valori possibili includono, ma non sono limitati a, quelli indicati nella tabella seguente.

Codice restituito	Descrizione
S_OK	Il metodo è riuscito.
MF_E_BUFFERTOOSMALL	Il metodo restituisce questo codice di errore se pbtDescriptionData non è NULL e il blocco di contesto è maggiore delle dimensioni specificate da pdwDescriptionDataSize. In tal caso, pdwDescriptionDataSize funge da parametro di output e riceve le dimensioni, in byte, del buffer richiesto.

Commenti

È possibile associare un solo blocco di dati di descrizione a una determinata voce in un determinato momento. Tuttavia, è possibile progettare diversi tipi di blocchi di dati di descrizione e identificare ogni tipo di blocco con un identificatore univoco globale (GUID). In questo modo, quando si chiama SetDescriptionData, è possibile contrassegnare il blocco di dati come di un tipo specifico. Quando si chiama GetDescriptionData, è possibile determinare il tipo del blocco di dati recuperato controllando il valore restituito in pGuidType.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	wmcodecdsp.h
DLL	Wmvdspa.dll

Vedi anche

ITocEntry

SetDescriptionData

Condividi tramite