Metodo IMFMediaTypeHandler::SetCurrentMediaType (mfidl.h)

  • Articolo

Imposta il tipo di supporto dell'oggetto.

Sintassi

HRESULT SetCurrentMediaType(
  [in] IMFMediaType *pMediaType
);

Parametri

[in] pMediaType

Puntatore all'interfaccia IMFMediaType del nuovo tipo di supporto.

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_INVALIDREQUEST
 Richiesta non valida.

Commenti

Per le origini multimediali, l'impostazione del tipo di supporto indica che l'origine genererà dati conformi a tale tipo di supporto. Per i sink multimediali, l'impostazione del tipo di supporto indica che il sink può ricevere dati conformi a tale tipo di supporto.

Qualsiasi implementazione di questo metodo deve verificare se pMediaType è diverso dal tipo di supporto corrente dell'oggetto. Se i tipi sono identici, il metodo deve restituire S_OK, ma evitare di rilasciare e ricreare le risorse inutilmente. Se i tipi non sono identici, il metodo deve convalidare il nuovo tipo.

Questa interfaccia è disponibile nelle piattaforme seguenti se vengono installati i componenti ridistribuibili di Windows Media Format 11 SDK:

  • Windows XP con Service Pack 2 (SP2) e versioni successive.
  • Windows XP Media Center Edition 2005 con KB900325 (Windows XP Media Center Edition 2005) e KB925766 (aggiornamento cumulativo di ottobre 2006 per Windows XP Media Center Edition) installato.

Requisiti

   
Client minimo supportato Windows Vista [app desktop | App UWP]
Server minimo supportato Windows Server 2008 [app desktop | App UWP]
Piattaforma di destinazione Windows
Intestazione mfidl.h
Libreria Mfuuid.lib

Vedi anche

IMFMediaTypeHandler