Metodo IMFSinkWriter::GetServiceForStream (mfreadwrite.h)

Esegue query sul sink multimediale sottostante o sul codificatore per un'interfaccia.

Sintassi

HRESULT GetServiceForStream(
  [in]  DWORD   dwStreamIndex,
  [in]  REFGUID guidService,
  [in]  REFIID  riid,
  [out] LPVOID  *ppvObject
);

Parametri

[in] dwStreamIndex

Indice in base zero di un flusso da eseguire in query o MF_SINK_WRITER_MEDIASINK per eseguire query sul sink multimediale stesso.

[in] guidService

GUID dell'identificatore del servizio o GUID_NULL. Se il valore è GUID_NULL, il metodo chiama QueryInterface per ottenere l'interfaccia richiesta. In caso contrario, il metodo chiama FMGetService::GetService. Per un elenco di identificatori di servizio, vedere Interfacce di servizio.

[in] riid

Identificatore dell'interfaccia (IID) dell'interfaccia richiesta.

[out] ppvObject

Riceve un puntatore all'interfaccia richiesta. Il chiamante deve rilasciare l'interfaccia.

Valore restituito

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Se il parametro dwStreamIndex è uguale a MF_SINK_WRITER_MEDIASINK, il metodo tenta di ottenere l'interfaccia dal sink multimediale. In caso contrario, tenta di ottenere l'interfaccia dal codificatore per il flusso in corrispondenza dell'indice specificato. In caso di errore o se non è presente alcun codificatore, il metodo tenta di ottenere l'interfaccia dal flusso nel sink multimediale.

Se i tipi di input e output del sink sono identici e compressi, è possibile che non sia necessaria alcuna codifica e che il codificatore video non venga creata un'istanza. In tal caso, GetServiceForStream restituirà MF_E_UNSUPPORTED_SERVICE.

Questa interfaccia è disponibile in Windows Vista se è installato l'aggiornamento della piattaforma per Windows Vista.

Requisiti

Vedi anche

FMSinkWriter

Sink Writer