Método IPrintCorePS2::GetFeatureAttribute (prcomoem.h)

Artículo
03/14/2023

El IPrintCorePS2::GetFeatureAttribute método recupera la lista de atributos de característica o el valor de un atributo de característica específico.

Sintaxis

HRESULT GetFeatureAttribute(
  [in]  PDEVOBJ pdevobj,
  [in]  DWORD   dwFlags,
  [in]  PCSTR   pszFeatureKeyword,
  [in]  PCSTR   pszAttribute,
  [out] PDWORD  pdwDataType,
  [out] PBYTE   pbData,
  [in]  DWORD   cbSize,
  [out] PDWORD  pcbNeeded
);

Parámetros

[in] pdevobj

Puntero a una estructura DEVOBJ .

[in] dwFlags

Está reservado y debe establecerse en cero.

[in] pszFeatureKeyword

Puntero a un búfer proporcionado por el autor de la llamada que contiene una cadena ASCII que especifica la palabra clave de característica única para la que se va a consultar. Este valor se puede obtener de una llamada anterior a IPrintCorePS2::EnumFeatures.

[in] pszAttribute

Puntero a un búfer proporcionado por el autor de la llamada que contiene una cadena ASCII que especifica el atributo único solicitado. Si este parámetro es NULL, el autor de la llamada solicita una lista de todos los nombres de atributo de características admitidos, en lugar de especificar un nombre de atributo de característica específico.

[out] pdwDataType

Puntero a una ubicación de memoria que recibe un valor que especifica el tipo de datos del atributo solicitado. Este valor es un enumerador de la enumeración EATTRIBUTE_DATATYPE , que se define en printoem.h.

[out] pbData

Puntero a un búfer proporcionado por el autor de la llamada que recibe los datos solicitados. Para consultar simplemente el número de bytes necesarios para satisfacer una solicitud, establezca este parámetro en NULL.

[in] cbSize

Especifica el tamaño, en bytes del búfer al que apunta pbData.

[out] pcbNeeded

Puntero a una ubicación de memoria que recibe el tamaño real, en bytes, de los datos solicitados.

Valor devuelto

Este método debe devolver uno de los valores siguientes.

Código devuelto	Descripción
S_OK	El método se ha llevado a cabo de forma correcta.
E_OUTOFMEMORY	El valor de cbSize era menor que el número de bytes que se van a escribir en el búfer de salida (el búfer al que apunta pbData). Se llamó al método con pbData establecido en NULL.
E_INVALIDARG	El método intentó consultar un atributo inexistente. No se reconoció la palabra clave feature. El parámetro pdevobj apuntaba a un objeto de contexto de controlador no válido.
E_FAIL	Error en el método.

Comentarios

Si se llama a este método con sus parámetros pszAttribute y pbData establecidos en NULL, el método devuelve con *pcbNeeded establecido en el número de bytes necesarios para la lista de todos los nombres de atributo admitidos para la característica. Si se llama al método una segunda vez, con pszAttribute establecido en NULL y pbData que apunta a un búfer del tamaño especificado en *pcbNeeded en la llamada anterior, el método devuelve con *pdwDataType establecido en kADT_ASCII (un enumerador del tipo enumerado EATTRIBUTE_DATATYPE ) y pbData que apunta a una lista delimitada por null de todos los nombres de atributo admitidos para la característica. Esta lista finaliza con dos caracteres NULL.

Para reducir la necesidad de realizar dos llamadas por acceso a datos, pase el método un búfer de salida de un tamaño fijo (por ejemplo, 1 KB) y, a continuación, compruebe el valor devuelto de la función. Si el método devuelve S_OK, el búfer ya contiene los datos de interés. Si el método devuelve E_OUTOFMEMORY, el valor de *pcbNeeded es el tamaño del búfer necesario para contener los datos de interés. A continuación, el autor de la llamada debe asignar un búfer de ese tamaño mayor y continuar con una segunda llamada al método .

Este método es compatible con cualquier complemento de representación de Pscript5.

Para obtener más información, vea Uso de GetFeatureAttribute.