Metodo IWMDMDevice2::GetFormatSupport2 (mswmdm.h)

Articolo
03/05/2024

Il metodo GetFormatSupport2 recupera i formati supportati dal dispositivo, inclusi i codec audio e video e i formati di file MIME.

Sintassi

HRESULT GetFormatSupport2(
  [in]  DWORD              dwFlags,
  [out] _WAVEFORMATEX      **ppAudioFormatEx,
  [out] UINT               *pnAudioFormatCount,
  [out] _VIDEOINFOHEADER   **ppVideoFormatEx,
  [out] UINT               *pnVideoFormatCount,
  [out] WMFILECAPABILITIES **ppFileType,
  [out] UINT               *pnFileTypeCount
);

Parametri

[in] dwFlags

DWORD specificando formati audio, formati video e tipi MIME. Questo flag specifica l'oggetto che l'applicazione richiede al provider di servizi di compilare. Il chiamante può impostare uno o più dei tre valori seguenti.

Valore	Descrizione
WMDM_GET_FORMAT_SUPPORT_AUDIO	Il provider di servizi deve compilare parametri audio.
WMDM_GET_FORMAT_SUPPORT_VIDEO	Il provider di servizi deve compilare parametri video.
WMDM_GET_FORMAT_SUPPORT_FILE	Il provider di servizi deve compilare i parametri di file.

[out] ppAudioFormatEx

Puntatore a una matrice di strutture _WAVEFORMATEX che specificano informazioni sui codec audio e sulle velocità di bit supportate dal dispositivo. La memoria per questo parametro viene allocata da Windows Media Gestione dispositivi e deve essere rilasciata dal chiamante con la funzione Win32 CoTaskMemFree.

[out] pnAudioFormatCount

Puntatore a un intero che specifica il numero di formati audio.

[out] ppVideoFormatEx

Puntatore a una matrice di strutture _VIDEOFORMATEX che specificano informazioni sui codici video e i formati supportati dal dispositivo. La memoria per questo parametro viene allocata da Windows Media Gestione dispositivi e deve essere rilasciata dal chiamante con la funzione Win32 CoTaskMemFree.

[out] pnVideoFormatCount

Puntatore a un numero intero che specifica il numero di formati video.

[out] ppFileType

Puntatore a una matrice di oggetti di tipo file WMFILECAPABILITIES . La memoria per questo parametro viene allocata da Windows Media Gestione dispositivi e deve essere rilasciata dal chiamante con la funzione Win32 CoTaskMemFree.

[out] pnFileTypeCount

Puntatore a un intero che specifica il conteggio dei tipi di file.

Valore restituito

Il metodo restituisce un HRESULT. Tutti i metodi di interfaccia in Windows Media Gestione dispositivi possono restituire una delle classi di codici di errore seguenti:

Codici di errore COM standard
Codici di errore di Windows convertiti in valori HRESULT
Codici di errore di Windows Media Gestione dispositivi

Per un elenco completo dei codici di errore possibili, vedere Codici di errore.

Commenti

Questo metodo estende IWMDMDevice::GetFormatSupport per gestire i formati video. Il metodo consigliato per ottenere il supporto del formato, tuttavia, è IWMDMDevice3::GetFormatCapability. Se GetFormatCapability non è supportato, il dispositivo probabilmente non supporterà il video e GetFormatSupport probabilmente è sufficiente.