Metodo IKsPropertySet::QuerySupported

  • Articolo

[La funzionalità associata a questa pagina, DirectShow, è una funzionalità legacy. È stata sostituita da MediaPlayer, FMMediaEngine e Audio/Video Capture in Media Foundation. Queste funzionalità sono state ottimizzate per Windows 10 e Windows 11. Microsoft consiglia vivamente che il nuovo codice usi MediaPlayer, FMMediaEngine e Audio/Video Capture in Media Foundation anziché DirectShow, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.

Il QuerySupported metodo determina se un oggetto supporta un set di proprietà specificato.

Sintassi

HRESULT QuerySupported(
  [in]  REFGUID guidPropSet,
  [in]  DWORD   dwPropID,
  [out] DWORD   *pTypeSupport
);

Parametri

guidPropSet [in]

GUID del set di proprietà.

dwPropID [in]

Identificatore della proprietà all'interno del set di proprietà.

pTypeSupport [out]

Puntatore a un valore in cui archiviare i flag che indicano il supporto fornito dal driver. I flag supportati includono quanto segue.

Valore Descrizione
KSPROPERTY_SUPPORT_GET È possibile recuperare la proprietà chiamando il metodo IKsPropertySet::Get .
KSPROPERTY_SUPPORT_SET È possibile modificare la proprietà chiamando IKsPropertySet::Set.

 

Valore restituito

Restituisce un valore HRESULT . Di seguito sono indicati alcuni valori possibili.

Codice restituito Descrizione
S_OK
 La combinazione di ID proprietà e set di proprietà specificata è supportata.
E_NOTIMPL
 Il set di proprietà non è supportato.
E_PROP_ID_UNSUPPORTED
 L'ID proprietà non è supportato per il set di proprietà specificato.
E_PROP_SET_UNSUPPORTED
 Il set di proprietà non è supportato.

 

Commenti

Nota

Un'altra interfaccia di questo nome esiste nel file di intestazione dsound.h. Le due interfacce non sono compatibili. L'interfaccia IKsControl , documentata in DirectShow DDK, è ora l'interfaccia consigliata per passare i set di proprietà tra i driver WDM e i componenti della modalità utente.

 

È necessario includere Ks.h prima di Ksproxy.h.

Requisiti

Requisito Valore
Client minimo supportato
 Windows 2000 Professional [solo app desktop]
Server minimo supportato
 Windows 2000 Server [solo app desktop]
Intestazione
Ks.h;
Ksproxy.h
Libreria
Strmiids.lib

Vedi anche

Codici errore e esito positivo

Interfaccia IKsPropertySet

Set di proprietà