AVC_FUNCTION_GET_PIN_DESCRIPTOR

아티클
06/15/2023

AVC_FUNCTION_GET_PIN_DESCRIPTOR 함수 코드는 각 핀 ID(0에서 오프셋)에 대한 핀 설명자를 가져옵니다.

I/O 상태 블록

성공하면 AV/C 프로토콜 드라이버는 Irp-IoStatus.Status>를 STATUS_SUCCESS 설정합니다.

가능한 다른 반환 값은 다음과 같습니다.

반환 값	Description
STATUS_TIMEOUT	요청이 이루어졌지만 모든 시간 제한 및 재시도 처리가 완료되기 전에는 응답을 받지 못했습니다.
STATUS_REQUEST_ABORTED	IRP 완료 상태 STATUS_REQUEST_ABORTED 즉시 중단합니다. 이는 디바이스가 제거되었거나 1394 버스에서 더 이상 사용할 수 없음을 나타냅니다.
상태_*	다른 반환 코드는 AV/C 프로토콜의 scope 초과한 오류 또는 경고가 발생했음을 나타냅니다.

의견

이 함수는 아래와 같이 AVC_MULTIFUNC_IRB 구조체의 PinDescriptor 멤버를 사용합니다.

typedef struct _AVC_MULTIFUNC_IRB {
  AVC_IRB  Common;
  union {
    .
    .
    .
    AVC_PIN_DESCRIPTOR PinDescriptor;
 .
    .
    .
  };
} AVC_MULTIFUNC_IRB, *PAVC_MULTIFUNC_IRB;

요구 사항

헤더:avc.h에 선언됩니다. avc.h를 포함합니다.

AVC_MULTIFUNC_IRB 입력

일반
이 멤버의 함수 하위 멤버는 AVC_FUNCTION 열거형에서 AVC_FUNCTION_GET_PIN_DESCRIPTOR 설정해야 합니다.

PinDescriptor
AV/C 하위 단위 디바이스의 핀에 대한 설명을 지정합니다.

이 함수 코드는 avc.sys가상 인스턴스에서 지원되지 않습니다.

핀 설명자 외에도 이 함수는 교차 처리기의 주소와 교차 처리기와 연결된 불투명 컨텍스트 값을 반환할 수도 있습니다. 교차 처리기 멤버가 NULL인 경우 하위 단위 드라이버는 교차 처리기를 제공해야 합니다. 교차 처리기 멤버가 NULL이 아닌 경우 교차 처리기가 제공되고 드라이버에서 사용할 수 있습니다.

Avc.sys 데이터 교차를 제공하지 않지만 필터 드라이버(예: avcstrm.sys)는 요청이 스택을 통해 다시 완료될 때 이를 채웁니다.

IRQL = PASSIVE_LEVEL 호출해야 합니다.