Função MFGetStrideForBitmapInfoHeader (mfapi.h)

  • Artigo

Calcula o passo mínimo da superfície para um formato de vídeo.

Sintaxe

HRESULT MFGetStrideForBitmapInfoHeader(
  [in]  DWORD format,
  [in]  DWORD dwWidth,
  [out] LONG  *pStride
);

Parâmetros

[in] format

Código FOURCC ou D3DFORMAT valor que especifica o formato de vídeo. Se você tiver um GUID de subtipo de vídeo, poderá usar o primeiro DWORD do subtipo.

[in] dwWidth

Largura da imagem, em pixels.

[out] pStride

Recebe o passo mínimo da superfície, em pixels.

Valor retornado

Se essa função for bem-sucedida, ela retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Essa função calcula o passo mínimo necessário para manter a imagem na memória. Use essa função se você estiver alocando buffers na memória do sistema. Superfícies alocadas na memória de vídeo podem exigir um passo maior, dependendo dos elementos gráficos cartão.

Se você estiver trabalhando com um buffer de superfície DirectX, use o método IMF2DBuffer::Lock2D para encontrar o passo da superfície.

Para formatos YUV planar, essa função retorna o passo para o plano Y. Dependendo do formato, os planos chroma podem ter um passo diferente.

Nota Antes do Windows 7, essa função era exportada de evr.dll. A partir do Windows 7, essa função é exportada de mfplat.dll e evr.dll exporta uma função stub que chama mfplat.dll. Para obter mais informações, consulte Alterações de biblioteca no Windows 7.
 

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 mfapi.h
Biblioteca Evr.lib
DLL Mfplat.dll

Confira também

Passo da imagem

Funções do Media Foundation