Método IKsFormatSupport::IsFormatSupported (devicetopology.h)

Artigo
08/23/2023

O método IsFormatSupported indica se o dispositivo de ponto de extremidade de áudio dá suporte ao formato de fluxo de áudio especificado.

Sintaxe

HRESULT IsFormatSupported(
  [in]  PKSDATAFORMAT pKsFormat,
  [in]  DWORD         cbFormat,
  [out] BOOL          *pbSupported
);

Parâmetros

[in] pKsFormat

Ponteiro para um especificador de formato de fluxo de áudio. Esse parâmetro aponta para um buffer alocado pelo chamador que contém um especificador de formato. O especificador começa com uma estrutura KSDATAFORMAT que pode ser seguida por informações de formato adicionais. Para obter mais informações sobre KSDATAFORMAT e especificadores de formato, consulte a documentação do DDK do Windows.

[in] cbFormat

O tamanho em bytes do buffer que contém o especificador de formato.

[out] pbSupported

Ponteiro para uma variável BOOL na qual o método grava um valor para indicar se o formato tem suporte. O método gravará TRUE se o dispositivo der suporte ao formato e FALSE se o dispositivo não der suporte ao formato.

Valor retornado

Se o método for bem-sucedido, retornará S_OK. Se falhar, os códigos de retorno possíveis incluem, mas não se limitam a, os valores mostrados na tabela a seguir.

Código de retorno	Descrição
E_POINTER	O ponteiro pKsFormat ou pbSupported é NULL.
E_INVALIDARG	O especificador de formato não é válido.

Requisitos


Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	devicetopology.h

Confira também

IKsFormatSupport Interface

Compartilhar via