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 |
|---|---|
|
Puntatore ppKsFormat è NULL. |
|
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 |