AVC_FUNCTION_GET_UNIQUE_ID

  • 아티클

AVC_FUNCTION_GET_UNIQUE_ID 함수 코드는 AV/C 단위의 고유 ID를 가져옵니다.

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 구조체의 UniqueID 멤버를 사용합니다.

typedef struct _AVC_MULTIFUNC_IRB {
  AVC_IRB  Common;
  union {
    .
    .
    .
    AVC_UNIQUE_ID UniqueID;
 .
    .
    .
  };
} AVC_MULTIFUNC_IRB, *PAVC_MULTIFUNC_IRB;

AVC_UNIQUE_ID 구조체의 멤버는 다음과 같습니다.

typedef struct _AVC_UNIQUE_ID {
    OUT GUID DeviceID;
} AVC_UNIQUE_ID, *PAVC_UNIQUE_ID;

요구 사항

헤더:avc.h로 선언되었습니다. avc.h를 포함합니다.

AVC_MULTIFUNC_IRB 입력

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

Uniqueid
단위 전체를 나타내는 GUID를 지정합니다. 동일한 단위 내의 모든 하위 단위는 동일한 GUID를 공유합니다. 두 단위가 동일한 GUID를 공유하지 않습니다.

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

하위 단위 드라이버는 디바이스 GUID를 제어 애플리케이션에 보고해야 하는 경우(동일한 단위에 속하는 많은 하위 단위 드라이버 인스턴스를 알아야 하는 애플리케이션) 또는 외부 플러그에 대한 자체 AVCPRECONNECTINFO 구조를 빌드하는 경우 이 함수를 사용합니다.

IRQL = PASSIVE_LEVEL 호출해야 합니다.

추가 정보

AVC_MULTIFUNC_IRB

AVC_UNIQUE_ID

AVCPRECONNECTINFO

AVC_FUNCTION