Metodo IKsFormatSupport::GetDevicePreferredFormat (devicetopology.h)

Il metodo GetDevicePreferredFormat ottiene il formato di flusso audio preferito per la connessione.

Sintassi

HRESULT GetDevicePreferredFormat(
  [out] PKSDATAFORMAT *ppKsFormat
);

Parametri

[out] ppKsFormat

Puntatore a una variabile puntatore in cui il metodo scrive l'indirizzo di un buffer contenente l'identificatore di formato per il formato preferito. L'identificatore inizia con una struttura KSDATAFORMAT che potrebbe essere seguita da informazioni di formato aggiuntive. Il metodo alloca l'archiviazione per l'identificatore di formato. Il chiamante è responsabile della liberazione dell'archiviazione, quando non è più necessario, chiamando la funzione CoTaskMemFree . Se il metodo ha esito negativo, *ppKsFormat è NULL. Per altre informazioni su KSDATAFORMAT, identificatori di formato e CoTaskMemFree, vedere la documentazione di Windows DDK.

Valore restituito

Se il metodo ha esito positivo, viene restituito S_OK. Se ha esito negativo, i codici restituiti possibili includono, ma non sono limitati a, i valori visualizzati nella tabella seguente.

Codice restituito	Descrizione
E_POINTER	Puntatore ppKsFormat è NULL.
E_OUTOFMEMORY	Memoria insufficiente.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	devicetopology.h

Vedi anche

Interfaccia IKsFormatSupport