Compartilhar via


Método IMDSPEnumDevice::Skip (mswmdm.h)

O método Skip ignora o próximo número especificado de interfaces de dispositivo de mídia na sequência de enumeração.

Sintaxe

HRESULT Skip(
  [in]  ULONG celt,
  [out] ULONG *pceltFetched
);

Parâmetros

[in] celt

Número de elementos a serem ignoradas.

[out] pceltFetched

Ponteiro para o número de elementos que realmente foram ignorados.

Retornar valor

O método retorna um HRESULT. Todos os métodos de interface no Windows Media Gerenciador de Dispositivos podem retornar qualquer uma das seguintes classes de códigos de erro:

  • Códigos de erro COM padrão
  • Códigos de erro do Windows convertidos em valores HRESULT
  • Códigos de erro do Windows Media Gerenciador de Dispositivos
Para obter uma lista abrangente de possíveis códigos de erro, consulte Códigos de erro.

Comentários

Se o número especificado no parâmetro celt for maior que o número real de interfaces restantes na sequência de enumeração, o valor retornado de Skip será S_FALSE. Quando isso acontece, o parâmetro pceltFetched deve ser consultado para determinar quantas interfaces foram ignoradas. Se você pular para o final da matriz de interfaces de dispositivo de mídia enumeradas, uma chamada subsequente para Avançar retornará S_FALSE.

Esse método deve ser implementado. Ele não deve retornar WMDM_E_NOTSUPPORTED ou E_NOTIMPL. Para obter mais informações, consulte Interfaces obrigatórias e opcionais.

Requisitos

Requisito Valor
Plataforma de Destino Windows
Cabeçalho mswmdm.h
Biblioteca Mssachlp.lib

Confira também

IMDSPEnumDevice Interface