estrutura SOURCE_MEDIA_A (setupapi.h)

Artigo
03/01/2024

A estrutura SOURCE_MEDIA é usada com a notificação SPFILENOTIFY_NEEDMEDIA para passar informações de mídia de origem.

Sintaxe

typedef struct _SOURCE_MEDIA_A {
  PCSTR Reserved;
  PCSTR Tagfile;
  PCSTR Description;
  PCSTR SourcePath;
  PCSTR SourceFile;
  DWORD Flags;
} SOURCE_MEDIA_A, *PSOURCE_MEDIA_A;

Membros

Reserved

Este membro não é usado no momento.

Tagfile

Arquivo de marca opcional que pode ser usado para identificar a mídia de origem.

Description

Descrição legível da mídia de origem.

SourcePath

Caminho para a origem que precisa da nova mídia.

SourceFile

Arquivo de origem a ser recuperado da nova mídia.

Flags

Copie as informações de estilo que modificam como os erros são tratados. Esse membro pode ser um ou mais dos valores a seguir.

SP_COPY_WARNIFSKIP

Informe ao usuário que ignorar o arquivo pode afetar a instalação.

SP_COPY_NOSKIP

Não ofereça ao usuário a opção de ignorar o arquivo.

SP_FLAG_CABINETCONTINUATION

O arquivo de origem atual continua em outro arquivo de gabinete.

SP_COPY_NOBROWSE

Não ofereça ao usuário a opção de procurar.

Comentários

Observação

O cabeçalho setupapi.h define SOURCE_MEDIA como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Cabeçalho	setupapi.h