Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
O método IPrintCorePS2::EnumFeatures enumera os recursos disponíveis de uma impressora.
Sintaxe
HRESULT EnumFeatures(
[in] PDEVOBJ pdevobj,
[in] DWORD dwFlags,
[out] PZZSTR pmszFeatureList,
[in] DWORD cbSize,
[out] PDWORD pcbNeeded
);
Parâmetros
[in] pdevobj
Ponteiro para uma estrutura de DEVOBJ.
[in] dwFlags
É reservado e deve ser definido como zero.
[out] pmszFeatureList
Ponteiro para um buffer fornecido pelo chamador que recebe uma lista delimitada por nulo de palavras-chave de recurso no formato MULTI_SZ. A lista é encerrada com dois caracteres nulos.
Defina esse parâmetro como NULL para simplesmente consultar o tamanho (*pcbNeeded) da lista de recursos sem ter a lista preenchida.
[in] cbSize
Especifica o tamanho, em bytes, do buffer apontado por pmszFeatureList.
[out] pcbNeeded
Ponteiro para um local de memória que recebe o tamanho real, em bytes, dos dados solicitados.
Valor de retorno
Esse método deve retornar um dos valores a seguir.
| Código de retorno | Descrição |
|---|---|
|
O método foi bem-sucedido. |
|
O valor em cbSize era menor do que o número de bytes a serem gravados no buffer de saída (o buffer apontado por pmszFeatureList).
O método foi chamado com pmszFeatureList definido como NULL. |
|
O parâmetro pdevobj apontou para um objeto de contexto de driver inválido. |
|
O método falhou. |
Observações
recursos de autoadesivas da impressora (consulte Substituindo Driver-Supplied Páginas da Folha de Propriedades), como aquelas que determinam a memória instalável e a presença de acessórios opcionais, estão incluídos na lista de palavras-chave do recurso, que aparece no buffer de saída apontado por pmszFeatureList. Para Pscript5, esses recursos têm o atributo de recurso OpenGroupType definido como "InstallableOptions".
Para reduzir a necessidade de fazer duas chamadas por acesso a dados, passe o método um buffer de saída de um tamanho fixo (1 KB, por exemplo) e verifique o valor retornado da função. Se o método retornar S_OK, o buffer já conterá os dados de interesse. Se o método retornar E_OUTOFMEMORY, o valor em *pcbNeeded será o tamanho do buffer necessário para manter os dados de interesse. Em seguida, o chamador deve alocar um buffer desse tamanho maior e continuar com uma segunda chamada para o método.
Esse método tem suporte para qualquer plug-in de renderização Pscript5.
Para obter mais informações, consulte Usando EnumFeatures.
Requisitos
| Requisito | Valor |
|---|---|
| da Plataforma de Destino | Área de trabalho |
| cabeçalho | prcomoem.h (inclua Prcomoem.h) |