Condividi tramite


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