GetPrintProcessorCapabilities 함수(winsplp.h)

인쇄 프로세서의 GetPrintProcessorCapabilities 함수는 지정된 입력 데이터 형식과 연결된 기능을 반환합니다.

구문

DWORD GetPrintProcessorCapabilities(
  [in]  LPTSTR  pValueName,
  [in]  DWORD   dwAttributes,
  [out] LPBYTE  pData,
  [in]  DWORD   nSize,
  [out] LPDWORD pcbNeeded
);

매개 변수

[in] pValueName

인쇄 프로세서에서 지원하는 데이터 형식을 나타내는 문자열에 대한 호출자 제공 포인터입니다. 문자열 포인터는 LPWSTR 형식이어야 합니다.

[in] dwAttributes

호출자가 제공한 특성 플래그입니다. PRINTER_INFO_x 구조체의 특성 멤버를 참조하세요.

[out] pData

PRINTPROCESSOR_CAPS_1 또는 PRINTPROCESSOR_CAPS_2 구조체에 대한 호출자 제공 포인터입니다.

[in] nSize

pData가 가리키는 버퍼의 크기를 나타내는 호출자 제공 값입니다.

값이 sizeof(PRINTPROCESSOR_CAPS_1)보다 작은 경우 이 함수는 인쇄 프로세서에서 지원하는 구조에 따라 sizeof(PRINTPROCESSOR_CAPS_1) 또는 sizeof(PRINTPROCESSOR_CAPS_2)와 같은 값을 제공해야 합니다.

값이 sizeof(PRINTPROCESSOR_CAPS_1)보다 작으면 winprint 인쇄 프로세서는 sizeof(PRINTPROCESSOR_CAPS_2)의 값을 제공합니다.

[out] pcbNeeded

pData가 가리키는 버퍼에 필요한 최소 크기를 받을 위치에 대한 호출자 제공 포인터입니다.

반환 값

작업이 성공하면 함수는 ERROR_SUCCESS 반환해야 합니다. 그렇지 않으면 Win32 오류 코드를 반환해야 합니다.

설명

인쇄 프로세서는 필요에 따라 GetPrintProcessorCapabilities 함수를 내보낼 수 있습니다. 함수의 목적은 인쇄 프로세서가 지원하는 모든 입력 데이터 형식에 대해 채워진 PRINTPROCESSOR_CAPS_1 또는 PRINTPROCESSOR_CAPS_2 구조를 반환하는 것입니다.

스풀러는 애플리케이션이 GetPrinterData를 호출할 때 인쇄 프로세서의 GetPrintProcessorCapabilities 함수를 호출하여 데이터 형식이 입력 데이터 형식의 이름인 PrintProcCaps_datatype 형식의 값 이름을 지정합니다. GetPrintProcessorCapabilities를 호출하기 전에 스풀러는 값 이름 문자열에서 PrintProcCaps_ 접두사를 제거합니다.

함수는 수신된 버퍼가 충분히 큰지 확인해야 하며, 이 경우 PRINTPROCESSOR_CAPS_1 또는 PRINTPROCESSOR_CAPS_2 구조체를 입력하고 반환해야 합니다. nSize 값은 PRINTPROCESSOR_CAPS_1 또는 PRINTPROCESSOR_CAPS_2 사용할지 여부를 결정합니다.

함수는 실제 버퍼가 충분히 큰지 여부에 관계없이 필요한 버퍼 크기를 반환하려면 항상 pcbNeeded 가 가리키는 위치를 사용해야 합니다.

지정된 반환 값은 스풀러가 GetPrinterData에 제공하는 반환 값이 됩니다.

요구 사항