Metodo IKsDataTypeCompletion::KsCompleteMediaType (ksproxy.h)
Il metodo KsCompleteMediaType completa un tipo di supporto parzialmente specificato che è stato presentato per la prima volta al metodo IAMStreamConfig::SetFormat .
Sintassi
HRESULT KsCompleteMediaType(
[in] HANDLE FilterHandle,
[in] ULONG PinFactoryId,
[in, out] AM_MEDIA_TYPE *AmMediaType
);
Parametri
[in] FilterHandle
Handle per il filtro KS sottostante.
[in] PinFactoryId
Identificatore della factory di pin in base al quale viene completato il tipo di supporto.
[in, out] AmMediaType
Puntatore a una struttura AM_MEDIA_TYPE che descrive il formato degli esempi multimediali. KsCompleteMediaType riceve campioni multimediali parzialmente specificati, completa la specifica e restituisce.
Valore restituito
Restituisce NOERROR se l'operazione ha esito positivo e il tipo di supporto è stato completato; in caso contrario, restituisce un codice di errore.
Commenti
Il metodo KsCompleteMediaType viene usato principalmente per i tipi di supporti video, in cui il membro biSizeImage della struttura KS_BITMAPINFOHEADER è noto solo al driver, a causa dei formati di compressione privati supportati. Se necessario, il gestore del tipo di dati può eseguire una query sul filtro KS sottostante per completare il tipo di supporto specificato.
Quando il proxy crea un'istanza del gestore dei tipi di dati ai fini del completamento di un tipo di supporto, il proxy passa il tipo di supporto al metodo IKsDataTypeHandler::KsSetMediaType per inizializzare prima il gestore del tipo di dati nel tipo di supporto specifico.
Per altre informazioni su IAMStreamConfig::SetFormat e AM_MEDIA_TYPE, vedere la documentazione di Microsoft Windows SDK.
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Desktop |
| Intestazione | ksproxy.h (include Ksproxy.h) |